--- updatedAt: 2026-09-24T11:41:29.000Z agentTools: projectIndex: https://api.fracttal.com/llms.txt --- # Crear una orden de trabajo Con esta API, puedes crear una orden de trabajo a partir de tareas pendientes, tareas no planificadas, eventos o solicitudes de trabajo ```http POST https://app.fracttal.com/api/work_orders ``` Con esta API, puedes crear una orden de trabajo de las siguientes maneras: * Desde tareas pendientes. * Desde una tarea no planificada. * Desde una tarea no planificada con información de un evento. * Desde una tarea lanzada por evento * Desde una solicitud de trabajo. Este servicio web hace parte del add-on APIS AVANZADAS **Notas:** 1. Para la creación de OTs con las tareas que se encuentran en tareas pendientes, tener en cuenta: Para obtener los IDs de las tareas pendientes que se desean llevar a OT se debe consultar la API [Consultar tareas pendientes](https://api.fracttal.com/update/reference/consultar-tareas-pendientes#/) 2. Para la creación de OTs mediante la creación desde una tarea no planificada, aquí existen las siguientes opciones: 1. OT no planificada, mediante está opción se deben enviar toda la información de la tarea al endpoint. 2. OT no planificada lanzada por evento, mediante esta opción la tarea tomará como base toda información contenida en evento del plan de tareas. Para esto tener en cuenta:
El evento del cual se traen los datos, no puede tener recursos asociados. Para obtener la información relacionada con el disparador y la tarea, es necesario consultar el servicio web [Consultar activadores de las tareas](https://api.fracttal.com/update/reference/consultar-activadores-de-las-tareas#/) 3. Para la creación de OTs con base en una solicitud de trabajo, la solicitud de trabajo debe estar activa y no puede estar asociada a otra OT. [Se pueden consultar las solicitudes de trabajo acá](https://api.fracttal.com/update/reference/consulta-de-solicitud#/) ## Parámetros de entrada para la creación de una OT desde una tarea pendiente La siguiente información debe ser enviada en el body de la petición.
Parámetros Tipo Requerido Descripción
type _Entero_ Sí Tipo de creación de ot, para este caso es 1
responsible_code _Texto_ Es opcional si se envía la información del tercero Código del recurso humano que será el responsable de la OT. [Se puede consultar aquí.](https://api.fracttal.com/reference/consulta-de-recursos-humanos) (campo _code_)
third_party_code _Texto_ Es opcional si se envía la información del recurso humano Código del tercero donde se encuentra el contacto que será el responsable de la OT. [Se puede consultar aquí.](https://api.fracttal.com/reference/consulta-de-terceros) (campo _code_)
third_party_contact _Texto_ Es opcional si se envía la información del recurso humano Nombre del contacto que será el responsable de la OT
account_code _Texto_ Sí Código de la cuenta de usuario que se registrará como el creador de la OT. El usuario debe ser de tipo recurso humano
tasks_todo _Array de json_ Sí Array con la información de las tareas pendientes. Cada json, debe contener el parámetro tasks_todo_id que corresponde al id de la tarea en tareas pendientes
annotations _Json_ No El objeto annotations debe cumplir con las siguientes reglas de validación: • Debe contener al menos uno de los campos permitidos: "id_wo_related" : "string", "code_wo_related" : "string", "wo_related_status" : "string"
## Parámetros Entrada para la creación de una OT desde una tarea no planificada La siguiente información debe ser enviada en el body de la petición. | Parámetro | Tipo | Requerido | Descripción | | :---------------------------------------- | :--------------- | :-------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | *Entero* | Sí | Tipo de creación de ot, para este caso es 2 | | item\_code | *Texto* | Si | Es el código del activo asociado a la OT. [Se puede consultar aquí.](https://api.fracttal.com/reference/consultar-un-activo) (campo *code*) | | responsible\_code | *Texto* | Si | Código del recurso humano o tercero asociado a la OT | | account\_code | *Texto* | Si | Código de la cuenta que realiza la OT. El usuario debe ser de tipo recurso humano | | requested\_by | *Texto* | Si | Solicitado por | | task\_descripcion | *Texto* | Si | Descripción de la tarea, la cual no debe superar 200 caracteres | | task\_type\_main | *Texto* | Si | Tipo de tarea | | task\_type\_description | *Texto* | Opcional | Clasificación 1 de tarea | | task\_type\_2\_description | *Texto* | Opcional | Clasificación 2 de tarea | | note | *Texto* | Opcional | Nota propia de la orden de trabajo. Se persiste y queda visible en el listado y el detalle de la OT (es independiente de la nota de la tarea utilizada en la creación desde tarea con información de un evento o desde tarea lanzada por evento, que no sufre cambios). | | label\_descriptions | *Array de texto* | Opcional | Descripciones de etiquetas ya existentes en el catálogo que se asociarán a la OT (no acepta IDs numéricos). Cada etiqueta debe existir previamente y estar habilitada para la compañía; no se crea automáticamente. Solo aplica cuando `type` es igual a 2. | **Reglas de **`label_descriptions`**:** * Solo puede enviarse cuando `type` es igual a 2. Si se envía con un `type` distinto, la petición se rechaza. * Cada elemento debe ser texto (no números ni objetos) y corresponder al nombre de una etiqueta ya existente y habilitada para la compañía. * Si alguna etiqueta indicada no existe o está deshabilitada, no se crea la OT ni la etiqueta — la operación es todo o nada. ## Parámetros Entrada para la creación de una OT desde una tarea no planificada con información de un evento La siguiente información debe ser enviada en el body de la petición. | Parámetro | Tipo | Requerido | Descripción | | :---------------------------------------- | :------- | :-------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | *Entero* | Sí | Tipo de creación de ot, para este caso es 3 | | item\_code | *Texto* | Sí | Código del activo al que se le realizará la OT | | responsible\_code | *Texto* | Es opcional si se envía la información del tercero | Código del recurso humano que será el responsable de la OT | | third\_party\_code | *Texto* | Es opcional si se envía la información del recurso humano | Código del tercero donde se encuentra el contacto que será el responsable de la OT | | third\_party\_contact | *Texto* | Es opcional si se envía la información del recurso humano | Nombre del contacto que será el responsable de la OT | | account\_code | *Texto* | Sí | Código de la cuenta de usuario que se registrará como el creador de la OT. El usuario debe ser de tipo recurso humano | | requested\_by | *Texto* | Sí | Solicitado por | | id\_task | *Entero* | Sí | Id de la tarea de la cual se obtendrá la información para crear la OT | | tasks\_triggers\_id | *Entero* | Sí | Id del evento se puede consultar en: [Consultar activadores de las tareas](https://api.fracttal.com/update/reference/consultar-activadores-de-las-tareas#/) es el campo id | | id\_group\_task | *Entero* | Sí | Id del plan de tareas donde se encuentra la tarea de la cual se obtendrá la información | | task\_descripcion | *Texto* | Opcional | Descripción de la tarea (Por defecto es el nombre de la tarea del id\_task), la cual no debe superar 200 caracteres | | task\_type\_main | *Texto* | Opcional | Tipo de tarea (Por defecto es de la tarea del id\_task) | | task\_type\_description | *Texto* | Opcional | Clasificación 1 de tarea (Por defecto es de la tarea del id\_task) | | task\_type\_2\_description | *Texto* | Opcional | Clasificación 2 de tarea (Por defecto es de la tarea del id\_task) | | note | *Texto* | Opcional | Nota de la tarea que se asocia a la OT |
## Parámetros Entrada para la creación de una OT desde una solicitud de trabajo La siguiente información debe ser enviada en el body de la petición. | Parámetro | Tipo | Requerido | Descripción | | :----------------------------- | :------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------ | | type | *Entero* | Sí | Tipo de creación de ot, para este caso es 2 | | item\_code | *Texto* | Si | Es el código del activo asociado a la OT. [Se puede consultar aquí.](https://api.fracttal.com/reference/consultar-un-activo) (campo *code*) | | responsible\_code | *Texto* | Si | Código del recurso humano o tercero asociado a la OT | | account\_code | *Texto* | Si | Código de la cuenta que realiza la OT. El usuario debe ser de tipo recurso humano | | requested\_by | *Texto* | Si | Solicitado por | | task\_descripcion | *Texto* | Si | Descripción de la tarea, la cual no debe superar 200 caracteres | | task\_type\_main | *Texto* | Si | Tipo de tarea | | id\_request | *Entero* | Si | Id de la solicitud de trabajo. [Se puede consultar aquí.](https://api.fracttal.com/reference/consulta-de-solicitudes) (campo *id\_code*) | ## Parámetros Entrada para la creación de una OT desde una tarea creada por evento La siguiente información debe ser enviada en el body de la petición. | Parámetro | Tipo | Requerido | Descripción | | :--------------------------------- | :------- | :-------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | *Entero* | Sí | Tipo de creación de ot, para este caso es 4 | | item\_code | *Texto* | Si | Código del activo al que se le realizará la OT | | responsible\_code | *Texto* | Opcional | Código del recurso humano que será el responsable de la OT | | third\_party\_code | *Texto* | Opcional | Código del tercero donde se encuentra el contacto que será el responsable de la OT | | third\_party\_contact | *Texto* | Opcional | Nombre del contacto que será el responsable de la OT | | account\_code | *Texto* | Si | Código de la cuenta de usuario que se registrará como el creador de la OT. El usuario debe ser de tipo recurso humano | | requested\_by | *Texto* | Si | Solicitado por | | id\_task | *Entero* | Si | Id de la tarea de la cual se obtendrá la información para crear la OT | | tasks\_triggers\_id | *Entero* | Si | Id del evento se puede consultar en: [Consultar activadores de las tareas](https://api.fracttal.com/update/reference/consultar-activadores-de-las-tareas#/) es el campo id | | id\_group\_task | *Entero* | Si | Id del plan de tareas donde se encuentra la tarea de la cual se obtendrá la información | | date\_maintenance | *Texto* | Opcional | Fecha de programación de la OT. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ | | note | *Texto* | Opcional | Nota de la tarea que se asocia a la OT | ## Parámetros de salida | Parámetro | Tipo | Descripción | | :----------------------------------------------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | | wo\_folio | *Texto* | Id de la OT | | creation\_date | *Texto* | Fecha de creación de la OT | | duration | *Entero* | Duración de la orden de trabajo | | id\_works\_ordes\_task | *Entero* | Id de la tarea | | id\_status\_work\_order | *Entero* | 1: OT en Proceso
2: OT en Revisión
3: OT Finalizada
4: OT cancelada | | final\_date | *Texto* | Fecha final de la tarea | | completed\_percentage | *Texto* | Porcentaje completado de la orden de trabajo | | created\_by | *Texto* | Nombre del Generador de la orden de trabajo | | code | *Texto* | Código del activo | | items\_log\_description | *Texto* | Descripción del activo | | done | *Texto* | True si la tarea ya está finalizada y False en caso de que la tarea no esté finalizada | | description | *Texto* | Descripción de la tarea | | id\_request | *Texto* | Id de la solicitud, si la tarea proviene de una solicitud | | stop\_assets | *Texto* | True si el activo está detenido y False en caso de que el activo NO está detenido | | stop\_assets\_sec | *Entero* | Tiempo de paro del activo (segundos) | | tasks\_log\_task\_type\_main | *Texto* | Tipo de tarea | | parent\_description | *Texto* | Localización del activo | | resources\_hours | *Texto* | Suma de horas de los recursos humanos utilizados | | trigger\_description | *Texto* | Tipo de Activador | | resources\_inventory | *Texto* | Recursos de tipo inventario en la tarea | | resources\_human\_resources | *Texto* | Recursos Humanos en la tarea | | cal\_date\_maintenance | *Texto* | Fecha calculada de la tarea | | real\_duration | *Entero* | Duración real de la tarea | | date\_maintenance | *Texto* | Fecha de programación de la tarea | | user\_assigned | *Texto* | Usuario Asignado | | note | *Texto* | Nota de la orden de trabajo | | details\_signature | *Texto* | Detalles de la firma de la orden de trabajo | | first\_date\_task | *Texto* | Fecha inicial de la tarea más próxima a realizarse | | costs\_center\_description | *Texto* | Centro de costos del activo | | tasks\_duration | *Texto* | Duración estimada de la tarea | | total\_cost\_task | *Texto* | Costo total de la OT | | requested\_by | *Texto* | Solicitante de una tarea no programada | | groups\_description | *Texto* | Información ‘Tipo’ de activo | | groups\_1\_description | *Texto* | Clasificación 1 de activo | | groups\_2\_description | *Texto* | Clasificación 2 de activo | | has\_children | *Texto* | True si la orden de trabajo tiene órdenes de trabajo hijas | | real\_stop\_assets\_sec | *Texto* | Tiempo real de parada del activo | | wo\_final\_date | *Texto* | Fecha final de la orden de trabajo | | tasks\_log\_types\_description | *Texto* | Clasificación 1 de la Tarea | | tasks\_log\_types\_2\_description | *Texto* | Clasificación 2 de la Tarea | | rating | *Texto* | Calificación de la OT | | code\_responsible | *Texto* | Código del responsable de la Ot | | work\_orders\_status\_custom\_description | *Texto* | Motivo de cancelación | | types\_description | *Texto* | Tipo de falla | | causes\_description | *Texto* | Causa de la falla | | detection\_method\_description | *Texto* | Método de detección de la falla | | severiry\_description | *Texto* | Severidad de la falla | | damages\_types\_description | *Texto* | Tipo de daño causado | | caused\_damage | *Texto* | Causa del daño causado | | id\_priorities | *Texto* | Id de la prioridad de la tarea | | priorities\_description | *Texto* | Descripción de la prioridad de la tarea | | annotations | *Json* | Objeto que contiene información adicional.
"id\_wo\_related" : "string", "code\_wo\_related" : "string", "wo\_related\_status" : "string" | ## Errores Errores propios de `label_descriptions` (`type = 2`): | Código | Causa | | ------ | ------------------------------------------------------------------------------------------- | | 400 | `label_descriptions` fue enviado con un `type` distinto a 2. | | 400 | `label_descriptions` no es un array. | | 400 | Algún elemento de `label_descriptions` no es texto. | | 400 | Alguna descripción de `label_descriptions` no existe o está deshabilitada para la compañía. | | 401 | Token de autenticación inválido, expirado o ausente. | | 403 | La cuenta no tiene permiso para crear órdenes de trabajo. | ## Ejemplo: **Tareas desde tareas pendientes:** Petición: **(POST)** ```json Body { "type":1, "responsible_code": "7809097-2", "account_code": "7845123", "tasks_todo":[ { "tasks_todo_id":1600093 }, { "tasks_todo_id":1087 } ], "annotations": { "id_wo_related": "12345", "code_wo_related": "WO-2025-001", "wo_related_status": "OPEN" } } ``` ```json Response { "success": true, "message": "200", "data": { "id": 1130348, "id_company": 69, "id_status_work_order": 1, "wo_folio": "OT-1731", "creation_date": "2021-07-27T14:43:38.330737+00:00", "duration": 1200, "id_assigned_user": null, "initial_date": null, "final_date": null, "completed_percentage": 0, "id_created_by": 40, "created_by": "Alejandra Arango", "signature": null, "note": null, "details_signature": null, "id_validated_by": null, "first_date_task": null, "id_personnel_log": 10073, "id_contacts_log": null, "id_parent": null, "is_offline": null, "id_account_offline": null, "code_created_by": "7845123", "rating": null, "enable_budget": false, "id_work_orders_status_custom": null, "review_date": null, "id_accounts_log_validated_by": null, "id_public": null, "statistics": null, "type_user": "HUMAN_RESOURCES", "id_responsible": 60, "id_account_responsible": null, "description": "OT-1731", "annotations": { "id_wo_related": "12345", "code_wo_related": "WO-2025-001", "wo_related_status": "OPEN" } } ``` **Creación de OTs desde una tarea no plantificada:** Petición: **(POST)** ```json Body { "type": 2, "item_code": "EQM032", "responsible_code": "RH-002", "account_code": "RH-002", "requested_by": "Ruben Prieto", "task_descripcion": "Orden de trabajo de prueba", "task_type_main": "Correctiva", "note": "Revisar antes del viernes", "label_descriptions": ["Urgente", "Garantía"] } ``` ```json Response { "success": true, "message": "200", "data": { "id_work_order": 11934394, "wo_folio": "OT-2420", "id_work_order_task": 20338615, "id_status_work_order": 1, "user_type": "HUMAN_RESOURCES", "responsible": "Pepito perez", "responsible_code": "RH-002", "date_created": "2023-11-10T20:44:59.479973+00:00", "created_by": "Pepito perez" }, "total": 1 } ``` **Respuesta — etiqueta inexistente o deshabilitada (400):** ```json { "success": false, "message": "Some label descriptions do not exist or are disabled: NoExiste", "total": 0, "data": null } ``` **Respuesta — **`label_descriptions`** enviado fuera de type = 2 (400):** ```json { "success": false, "message": "label_descriptions is only supported when type = 2 (Unplanned Task)", "total": 0, "data": null } ``` **Creación de OTs desde una tarea no planificada con información de un evento:** Petición: **(POST)** ```json Body { "type": 3, "item_code": "118", "responsible_code": "32322", "account_code": "25198772-2", "requested_by": "Fracttal SPA", "id_task": 86, "task_descripcion": "Nueva tarea generada por API", "tasks_triggers_id": 27, "id_group_task": 1, "task_type_main": "Correctiva", "task_type_description": "MECÁNICA", "task_type_2_description": "REQUIERE PERMISO ALTURA" } ``` ```json Response { "success": true, "message": "200", "data": { "wo_folio": "OT-1694", "id_status_work_order": 1, "responsible": "FRACTTAL SPA", "responsible_code": "32322", "date_created": "2021-05-11T14:54:45.294203+00:00", "created_by": "Laura Marcela Peña Jaramillo" }, "total": 1 } ```
**Creación de OTs desde una solicitud de trabajo:** Petición: **(POST)** ```json Body { "type": 2, "item_code": "EQM032", "responsible_code": "RH-002", "account_code": "RH-002", "requested_by": "Ruben Prieto", "task_descripcion": "Orden de trabajo de prueba", "task_type_main": "Correctiva", "id_request": 1827 } ``` ```json Response { "success": true, "message": "200", "data": { "id_work_order": 11934394, "wo_folio": "OT-2420", "id_work_order_task": 20338615, "id_status_work_order": 1, "user_type": "HUMAN_RESOURCES", "responsible": "Pepito perez", "responsible_code": "RH-002", "date_created": "2023-11-10T20:44:59.479973+00:00", "created_by": "Pepito perez" }, "total": 1 } ``` {` `} **Creación de Ots desde una tarea lanzada por evento:** Petición: **(POST)** ```json Body { "type": 4, "responsible_code": "SV-CODE", "account_code": "SV-CODE", "item_code": "F1_1190-ASST-CODE", "id_group_task": 277312, "id_task": 14011472, "task_trigger_id": 14011472, "date_maintenance": "2016-07-12T20:00:00-03", //Opcional "note": "TEST NOTE" //Opcional } ``` ```json Response { "success": true, "message": "200", "data": { "wo_folio": "OT-1694", "id_status_work_order": 1, "responsible": "FRACTTAL SPA", "responsible_code": "32322", "date_created": "2021-05-11T14:54:45.294203+00:00", "created_by": "Laura Marcela Peña Jaramillo" }, "total": 1 } ``` # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "crear-una-orden-de-trabajo", "version": "1-Es" }, "servers": [ { "url": "https://app.fracttal.com/api/work_orders" } ], "security": [ {} ], "paths": { "/": { "post": { "summary": "Crear una orden de trabajo", "description": "Con esta API, puedes crear una orden de trabajo a partir de tareas pendientes, tareas no planificadas, eventos o solicitudes de trabajo", "operationId": "crear-una-orden-de-trabajo", "security": [] } } }, "x-readme": { "headers": [], "explorer-enabled": false, "proxy-enabled": true }, "x-readme-fauxas": true } ```