put
https://app.fracttal.com/api/work_orders_labels/
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_descriptionsnã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âmetro | Tipo | Requerido | Descrição |
|---|---|---|---|
folio | Texto | Sim* | Folio da OT (ex: "WO-151-2026"). Requerido se não for enviado na URL. |
label_descriptions | Array | Sim | Array com as descrições das etiquetas a serem atribuídas. |
account_code | Texto | Sim | Có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âmetro | Tipo | Descrição |
|---|---|---|
wo_folio | Texto | Folio da OT (ex: "WO-151-2026") |
labels_count | Inteiro | Número total de etiquetas vinculadas após a atualização. |
labels | Array | Lista 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
}
]
}
} 200