get
https://app.fracttal.com/api/work_orders_labels/
Este endpoint retorna el catálogo completo de labels (etiquetas) habilitadas de la empresa del despachador autenticado. Las labels se utilizan para clasificar las órdenes de trabajo y se devuelven ordenadas alfabéticamente por su description. La consulta es de solo lectura y no modifica información.
Parámetros de entrada
Se envían dentro de body:
Requeridos
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
account_code | Texto | Sí | Código del personal con cuenta de despacho activa. Se obtiene del campo code en el endpoint de personal. No puede ser nulo ni vacío. |
Opcionales
Ninguno.
Parámetros de salida
Respuesta exitosa HTTP 200:
| Parámetro | Tipo | Descripción |
|---|---|---|
success | Booleano | true si la operación fue exitosa. |
message | Texto | Código HTTP de respuesta. |
total | Entero | Número de labels retornadas. |
data | Array de JSON | Array de objetos label. |
Estructura de cada objeto de data:
| Campo | Tipo | Descripción |
|---|---|---|
id | Entero | Identificador único de la label. |
id_company | Entero | Identificador de la empresa propietaria de la label. |
description | Texto | Nombre o descripción de la label. |
color | Texto | Color de la label en formato hexadecimal (sin #). |
enabled | Booleano | true si la label está habilitada. |
Validaciones y errores
400—account_codefaltante, nulo o vacío.401— Sin autenticación o cuenta no autorizada como despachador.404—account_codeno existe en personal o no tiene cuenta activa.500— Error interno del sistema.
Ejemplo:
Petición: (GET) https://app.fracttal.com/api/work_orders_labels/
Body:
{
"account_code": "USR001"
}Response:
{
"success": true,
"message": "200",
"total": 3,
"data": [
{"id": 1001, "id_company": 5, "description": "Correctivo", "color": "FF0000", "enabled": true},
{"id": 1002, "id_company": 5, "description": "Preventivo", "color": "00FF00", "enabled": true},
{"id": 1003, "id_company": 5, "description": "Predictivo", "color": "0000FF", "enabled": true}
]
}