put
https://app.fracttal.com/api/work_orders_labels/
Mediante esta API se pueden actualizar las etiquetas asociadas a una orden de trabajo.
Notas importantes:
- Validación previa: Si alguna de las etiquetas enviadas en
label_descriptionsno existe o está deshabilitada, la petición retornará un error 400 y no se realizará ningún cambio. - Case-sensitive: Los nombres de las etiquetas deben coincidir exactamente con los configurados en el sistema (Mayúsculas/Minúsculas).
Parámetros de entrada
Se puede filtrar la información mediante el siguiente body:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
folio | Texto | Sí* | Folio de la OT (ej: "WO-151-2026"). Requerido si no se envía en la URL. |
label_descriptions | Array | Sí | Array con las descripciones de las etiquetas a asignar. |
account_code | Texto | Si | Código del usuario que realiza la operación. Debe corresponder a un código válido en el sistema de personal con cuenta asociada. |
Nota: El campo folio puede enviarse en la URL o en el body. Si se envía en ambos lugares, prevalece el valor de la URL.
Parámetros de salida
| Parámetro | Tipo | Descripción |
|---|---|---|
wo_folio | Texto | Folio de la OT (ej: "WO-151-2026") |
labels_count | Entero | Número total de etiquetas vinculadas tras la actualización. |
labels | Array | Lista de objetos con la información de cada etiqueta (id, color, descripción, etc). |
Ejemplo:
Petición: **(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