Actualizar datos de una solicitud de trabajo

Mediante esta API se puede actualizar los datos de una solicitud de trabajo creada en Fracttal.

Campos actualizables

Puedes actualizar los siguientes campos de una solicitud de trabajo:

  • Activo (item_code + id_type_item): El activo asociado a la solicitud
  • Referencia (identifier): Identificador de referencia
  • Grupo (types_description): Categoría principal de la solicitud
  • Clasificación 1 (types_1_description): Primera clasificación
  • Clasificación 2 (types_2_description): Segunda clasificación
  • Palabras clave (key_words_descriptions): Tags o etiquetas asociadas

Restricciones

  • Solo se pueden actualizar solicitudes en estado Abierta
  • Se requieren permisos de administrador de solicitudes de trabajo
  • Los campos deben actualizarse mediante sus descripciones, no mediante IDs
  • Al actualizar el activo, se deben proporcionar tanto item_code como id_type_item

Consideraciones

  • Las descripciones de tipos y clasificaciones son case-insensitive (no distinguen mayúsculas/minúsculas)
  • Las palabras clave deben existir previamente en el sistema

Parámetros de entrada

Los siguientes campos deben ser enviados para que se actualicen los datos de una solicitud de trabajo:

ParámetroTipoRequeridoDescripción
codeTextoNúmero de la solicitud. Se puede consultar aquí. (campo id)
user_codeTextoCódigo del usuario que actualiza la solicitud. Es el código del recurso humano o tercero asociado a la cuenta.
item_codeNúmeroNo*Código del activo a asociar. *Requerido si se envía id_type_item.
id_type_itemTextoNo*Tipo de activo (1=Ubicaciones, 2=Equipos, 3=Herramientas, 5=Digitales) *Requerido si se envía item_code.
identifierTextoNoReferencia o identificador de la solicitud.
types_descriptionTextoNoDescripción del Grupo (categoría principal). Debe existir en el catálogo y estar habilitada.
types_1_descriptionTextoNoDescripción de la Clasificación 1. Debe existir en el catálogo y estar habilitada.
types_2_descriptionTextoNoDescripción de la Clasificación 2. Debe existir en el catálogo y estar habilitada.
key_words_descriptionsTexto o Array[Texto]NoPalabra(s) clave a asociar. Puede ser un texto para una sola palabra o un array para múltiples. Todas deben existir previamente en el sistema y estar habilitadas.

Ejemplo:

Petición: (PUT)https://app.fracttal.com/api/work_requests_data/38

{
    "user_code": "TestAdmin",
    "code": 3843,
    "item_code": "TestActivo",
    "id_type_item": 1,
    "types_description": "Grupo test",
    "types_1_description": "Clasificacion 1 test",
    "types_2_description": "Clasificacion 2 test",
    "key_words_descriptions": [
        "test 1",
        "test 2"
    ],
    "identifier": "test2"
}
{
    "success": true,
    "message": "200",
    "data": [
        {
            "id_code": 38,
            "id_company": 1,
            "id_work_order": null,
            "date": "2025-11-13T12:09:39.851315+00:00",
            "id_type": null,
            "id_item": 1,
            "is_urgent": false,
            "description": "description test",
            "rating": null,
            "rating_notes": null,
            "observation": null,
            "date_solution": null,
            "types_description": null,
            "items_description": "test",
            "id_requests_x_status":111,
            "id_status": 1,
            "date_status": "2025-11-13T12:09:39.851315+00:00",
            "requests_x_status_notes": "test",
            "requests_x_status_description": "OPEN_STATUS",
            "status_path_image": "color: #FFD73A",
            "accounts_name": "User",
            "accounts_email": "[email protected]",
            "requests_x_key_words_descriptions": null,
            "requests_x_key_words_id_key_words": null,
            "wo_folio": null,
            "date_incident": "2025-11-13T12:08:51.404+00:00",
            "parent_description": "//",
            "requests_x_status_accounts_name": "User",
            "requested_by": "User",
            "id_type_1": null,
            "id_type_2": null,
            "types_1_description": null,
            "types_2_description": null,
            "identifier": "",
            "id_personnel_log": 1,
            "id_contacts_log": null,
            "id_account": 1,
            "geolocation": null,
            "id_user": 1,
            "date_maintenance": null,
            "types_color": null,
            "id_group_task": 1,
            "id_item_log": 1,
            "visible_to_all": false,
            "id_priority": 5,
            "priorities_description": "VERY_LOW",
            "email_requested_by": "",
            "code_item": "U01",
            "id_cost_center": 1,
            "costs_center_description": "1",
            "id_group": 1,
            "id_group_1": 1,
            "id_group_2": 1,
            "groups_description": "TEST",
            "groups_1_description": "TEST",
            "groups_2_description": "TEST",
            "requests_x_status_third_parties_name": null,
            "annotations": null,
            "id_related": null
        }
    ],
    "total": "1"
}
Path Params
string
required
Response
200
Language
LoadingLoading…