Crea un recurso. El conjunto de campos obligatorios depende del tipo de cálculo.
v1/resources/add.php
Parámetros
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre |
| type | string | Sí | Tipo de cálculo: «rate», «percent» o «amortized» |
| dynamic | int | No | 1: el precio de una tarifa fija o el porcentaje de un recurso porcentual se indica en los componentes del producto. Por defecto 0. No se usa en la amortización |
| unit | string | Para rate y amortized | Unidad de medida, un código de Unidades de medida. No hace falta en una tarifa con dynamic 1 |
| price | float | Para rate | Precio por unidad. No hace falta en una tarifa con dynamic 1 |
| base | string | Para percent | Base de cálculo: «cost» o «price» |
| percent | float | Para percent | Porcentaje. No hace falta con dynamic 1 |
| initial_cost | float | Para amortized | Coste inicial |
| useful_life | float | Para amortized | Vida útil, en unidades de unit |
| notes | string | No | Notas |
| categories | array | No | Categorías: objetos con id o name |
Una categoría se puede pasar por nombre: si no existe, se crea. Los ID de las categorías existentes los devuelve v1/categories/get_list.
Tipos de recurso
El tipo de cálculo determina qué campos hacen falta al crear un recurso.
| Tipo | Descripción | Campos obligatorios |
|---|---|---|
| «rate», Tarifa fija | Mano de obra, electricidad, fabricación por contrato | unit, price |
| «rate» con dynamic 1, El precio se indica en los componentes del producto | El importe se fija en los componentes de cada producto | Ninguno |
| «percent», Porcentaje | Gastos generales, comisiones | base, percent |
| «percent» con dynamic 1, El porcentaje se indica en los componentes del producto | El porcentaje se fija en los componentes de cada producto | base |
| «amortized», Amortización | Equipos, vehículos, herramientas | unit, initial_cost, useful_life |
La base de cálculo (base) de un recurso porcentual:
- «cost»: el coste del producto sin los recursos porcentuales;
- «price»: el precio de venta de la ficha del producto.
Unidades de medida
A un recurso se le puede asignar cualquier unidad, incluidas las de tiempo y energía disponibles solo para los recursos: «h», «min», «kWh». Consulta la lista en Unidades de medida.
Ejemplos de solicitud
Una tarifa fija: la tarifa por hora de un carpintero.
{
"name": "Trabajo del carpintero",
"type": "rate",
"unit": "h",
"price": 600,
"categories": [{ "id": 31 }]
}
Un porcentaje del coste, igual para todos los productos:
{
"name": "Gastos generales",
"type": "percent",
"base": "cost",
"percent": 10
}
Una comisión del marketplace cuyo porcentaje se fija en los componentes de cada producto:
{
"name": "Comisión del marketplace",
"type": "percent",
"dynamic": 1,
"base": "price"
}
Amortización de un equipo:
{
"name": "Fresadora",
"type": "amortized",
"unit": "h",
"initial_cost": 600000,
"useful_life": 2000
}
Ejemplo de respuesta
{
"success": true,
"resource_id": 57
}
Errores
| Error | Motivo |
|---|---|
| No name in input | Falta un campo obligatorio (en lugar de name, el nombre del campo: type o un campo obligatorio del tipo) |
| Name must not be empty | Nombre vacío |
| Name must be a string | El nombre no se envió como cadena, p. ej. como array |
| Invalid type value. Must be one of: rate, percent, amortized | type no válido |
| Unit not set | Se envió una unidad de medida vacía |
| Unit not found | Unidad de medida desconocida |
| Invalid price value. Must be a number, 0 or greater | El precio no es un número o es menor que 0 (igual para initial_cost) |
| Invalid base value. Must be one of: cost, price | Base de cálculo no válida |
| Percent must be greater than 0 and not exceed 100 | El porcentaje es 0, menor que 0 o mayor que 100 |
| Useful life must be greater than 0 | La vida útil es 0 o menor |
| Category 12 not found | Categoría no encontrada |