Atualizar dados de uma solicitação de trabalho

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_code quanto id_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âmetroTipoRequeridoDescrição
codeTextoSimNúmero da solicitação. Pode ser consultado aqui. (campo id)
user_codeTextoSimCódigo do usuário que atualiza a solicitação. É o código do recurso humano ou terceiro associado à conta.
item_codeNúmeroNão*Código do ativo a associar. *Requerido se id_type_item for enviado.
id_type_itemTextoNão*Tipo de ativo (1=Localizações, 2=Equipamentos, 3=Ferramentas, 5=Digitais) *Requerido se item_code for enviado.
identifierTextoNãoReferência ou identificado da solicitação.
types_descriptionTextoNãoDescrição do Grupo (categoria principal). Deve existir no catálogo e estar habilitada.
types_1_descriptionTextoNãoDescrição da Classificação 1. Deve existir no catálogo e estar habilitada.
types_2_descriptionTextoNãoDescrição da Classificação 2. Deve existir no catálogo e estar habilitada.
key_words_descriptionsTexto ou Array[Texto]NãoPalavra(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"
}
Path Params
string
required
Response
200
Language
LoadingLoading…