Maxim

Maxim

Última actualización el Oct 8, 2026

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