Devuelve los recursos de la empresa, ordenados por nombre. Los recursos archivados también se incluyen.
v1/resources/get_list.php
Parámetros
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| limit | int | No | Tamaño de página, de 1 a 1000 |
| offset | int | No | Cuántos registros omitir |
Sin limit se devuelve toda la lista. Consulta la paginación en Reglas generales.
Respuesta
Un array resources con los campos del recurso y sus categorías. El campo total contiene el número total de recursos.
| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID del recurso |
| name | string | Nombre |
| type | string | Tipo de cálculo: «rate», «percent» o «amortized» |
| dynamic | int | 1 si el precio o el porcentaje se indica en los componentes del producto |
| base | string | Base de cálculo de un recurso porcentual: «cost» o «price». null en los demás tipos |
| unit | string | Unidad de medida, un código de Unidades de medida. Presente solo en la tarifa fija y la amortización, null en el resto |
| price | float | Precio por unidad |
| percent | float | Porcentaje de un recurso porcentual |
| initial_cost | float | Coste inicial del equipo |
| useful_life | float | Vida útil, en las unidades del recurso |
| left_life | float | Vida útil restante. Disminuye cuando el recurso se consume en producción |
| notes | string | Notas |
| archived | int | 1 si el recurso está archivado |
| categories | array | Categorías del recurso: objetos con id y name |
Ejemplo de solicitud
{
"limit": 100,
"offset": 0
}
Ejemplo de respuesta
{
"success": true,
"resources": [
{
"id": 57,
"name": "Trabajo del carpintero",
"type": "rate",
"dynamic": 0,
"base": null,
"unit": "h",
"price": 600,
"percent": 0,
"initial_cost": 0,
"useful_life": 0,
"left_life": 0,
"notes": "",
"archived": 0,
"categories": [
{
"id": 31,
"name": "Personal"
}
]
},
{
"id": 59,
"name": "Fresadora",
"type": "amortized",
"dynamic": 0,
"base": null,
"unit": "h",
"price": 300,
"percent": 0,
"initial_cost": 600000,
"useful_life": 2000,
"left_life": 1874.5,
"notes": "",
"archived": 0,
"categories": []
}
],
"total": 2
}
Errores
| Error | Motivo |
|---|---|
| Invalid limit value. Must be between 1 and 1000 | limit no válido |
| Invalid offset value. Must be 0 or greater | offset no válido |
| Offset requires limit | se envió offset sin limit |