put
https://app.fracttal.com/api/work_requests_data/
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_codecomoid_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ámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
code | Texto | Sí | Número de la solicitud. Se puede consultar aquí. (campo id) |
user_code | Texto | Sí | Código del usuario que actualiza la solicitud. Es el código del recurso humano o tercero asociado a la cuenta. |
item_code | Número | No* | Código del activo a asociar. *Requerido si se envía id_type_item. |
id_type_item | Texto | No* | Tipo de activo (1=Ubicaciones, 2=Equipos, 3=Herramientas, 5=Digitales) *Requerido si se envía item_code. |
identifier | Texto | No | Referencia o identificador de la solicitud. |
types_description | Texto | No | Descripción del Grupo (categoría principal). Debe existir en el catálogo y estar habilitada. |
types_1_description | Texto | No | Descripción de la Clasificación 1. Debe existir en el catálogo y estar habilitada. |
types_2_description | Texto | No | Descripción de la Clasificación 2. Debe existir en el catálogo y estar habilitada. |
key_words_descriptions | Texto o Array[Texto] | No | Palabra(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"
} 200