Actualizar etiquetas de una OT

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_descriptions no 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ámetroTipoRequeridoDescripción
folio TextoSí*Folio de la OT (ej: "WO-151-2026"). Requerido si no se envía en la URL.
label_descriptions ArrayArray con las descripciones de las etiquetas a asignar.
account_code TextoSiCó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ámetroTipoDescripción
wo_folio TextoFolio de la OT (ej: "WO-151-2026")
labels_count EnteroNúmero total de etiquetas vinculadas tras la actualización.
labels ArrayLista 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
            }
        ]
    }
}
Path Params
string
required
Response
200
Language
LoadingLoading…