put
https://app.fracttal.com/api/work_requests_data/
Mediante esta API é possível atualizar os dados de uma solicitação de trabalho criada no Fracttal.
Campos atualizáveis
Você pode atualizar os seguintes campos de uma solicitação de trabalho:
- Ativo (
item_code+id_type_item): O ativo associado à solicitação - Referência (
identifier): Identificador de referência - Grupo (
types_description): Categoria principal da solicitação - Classificação 1 (
types_1_description): Primeira classificação - Classificação 2 (
types_2_description): Segunda classificação - Palavras-chave (
key_words_descriptions): Tags ou etiquetas associadas
Restrições
- Apenas solicitações em estado Aberta podem ser atualizadas
- São necessários permissões de administrador de solicitações de trabalho
- Os campos devem ser atualizados por meio de suas descrições, não por meio de IDs
- Ao atualizar o ativo, devem ser fornecidos tanto
item_codequantoid_type_item
Considerações
- As descrições de tipos e classificações não diferenciam maiúsculas de minúsculas (case-insensitive)
- As palavras-chave devem existir previamente no sistema
Parâmetros de entrada
Os seguintes campos devem ser enviados para que os dados de uma solicitação de trabalho sejam atualizados:
| Parâmetro | Tipo | Requerido | Descrição |
|---|---|---|---|
code | Texto | Sim | Número da solicitação. Pode ser consultado aqui. (campo id) |
user_code | Texto | Sim | Código do usuário que atualiza a solicitação. É o código do recurso humano ou terceiro associado à conta. |
item_code | Número | Não* | Código do ativo a associar. *Requerido se id_type_item for enviado. |
id_type_item | Texto | Não* | Tipo de ativo (1=Localizações, 2=Equipamentos, 3=Ferramentas, 5=Digitais) *Requerido se item_code for enviado. |
identifier | Texto | Não | Referência ou identificado da solicitação. |
types_description | Texto | Não | Descrição do Grupo (categoria principal). Deve existir no catálogo e estar habilitada. |
types_1_description | Texto | Não | Descrição da Classificação 1. Deve existir no catálogo e estar habilitada. |
types_2_description | Texto | Não | Descrição da Classificação 2. Deve existir no catálogo e estar habilitada. |
key_words_descriptions | Texto ou Array[Texto] | Não | Palavra(s) chave a associar. Pode ser um texto para uma única palavra ou um array para múltiplas. Todas devem existir previamente no sistema e estar habilitadas. |
Exemplo:
Requisição: (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