Atualizar etiquetas de uma OT

Por meio desta API, é possível atualizar as etiquetas associadas a uma ordem de trabalho.

Notas importantes:

  • Validação prévia: Se alguma das etiquetas enviadas em label_descriptions não existir ou estiver desabilitada, a solicitação retornará um erro 400 e nenhuma alteração será feita.
  • Case-sensitive: Os nomes das etiquetas devem coincidir exatamente com os configurados no sistema (Maiúsculas/Minúsculas).

Parâmetros de entrada

Pode-se filtrar a informação através do seguinte corpo:

ParâmetroTipoRequeridoDescrição
folio TextoSim*Folio da OT (ex: "WO-151-2026"). Requerido se não for enviado na URL.
label_descriptions ArraySimArray com as descrições das etiquetas a serem atribuídas.
account_code TextoSimCódigo do usuário que realiza a operação. Deve corresponder a um código válido no sistema de pessoal com conta associada.

Nota: O campo folio pode ser enviado na URL ou no corpo. Se for enviado em ambos os lugares, prevalece o valor da URL.

Parâmetros de saída

ParâmetroTipoDescrição
wo_folio TextoFolio da OT (ex: "WO-151-2026")
labels_count InteiroNúmero total de etiquetas vinculadas após a atualização.
labels ArrayLista de objetos com a informação de cada etiqueta (id, cor, descrição, etc).

Exemplo:

Solicitação: **(PUT)https://app.fracttal.com/api/work_orders_labels/WO-151-2026

{
    "account_code": "USR001",
    "folio": "WO-151-2026",
    "label_descriptions": [
      "Pendiente",
      "Pendiente de autorización del cliente"
    ]
  }
{
    "success": true,
    "message": "200",
    "total": 2,
    "data": {
        "wo_folio": "WO-151-2026",
        "id_status": 3,
        "labels_count": 2,
        "id_work_order": 30079240,
        "labels": [
            {
                "id": 12,
                "description": "Pendiente",
                "color": "1c2749",
                "enabled": true
            },
            {
                "id": 744,
                "description": "Pendiente de autorización del cliente",
                "color": "080de8",
                "enabled": true
            }
        ]
    }
}
Path Params
string
required
Response
200
Language
LoadingLoading…