Maxim

Maxim

Última actualización el Oct 8, 2026

Crea un material. El material aparece en el almacén storage_id y en los almacenes que guardan todos los materiales o sus categorías.

v1/materials/add.php

Parámetros

Campo Tipo Obligatorio Descripción
name string Sí Nombre
unit string Sí Unidad de medida, un código de Unidades de medida
storage_id int Sí Almacén donde se crean las existencias
sku string No SKU
price float No Precio por unidad. Por defecto 0
stock float No Existencias iniciales en el almacén storage_id. Por defecto 0
minimum float No Existencias mínimas en el almacén storage_id. Por defecto 0
notes string No Notas
categories array No Categorías: objetos con id o name
suppliers array No Proveedores: objetos con id

Una categoría se puede pasar por nombre: si no existe, se crea. Los ID de las categorías y los proveedores existentes los devuelven v1/categories/get_list y v1/suppliers/get_list.

La unicidad del SKU no se comprueba.

Ejemplo de solicitud

{
    "name": "Tablón de roble",
    "sku": "M010",
    "unit": "m3",
    "price": 130000,
    "storage_id": 3998,
    "stock": 2.5,
    "minimum": 0.5,
    "categories": [{ "id": 12 }, { "name": "Herrajes" }],
    "suppliers": [{ "id": 45 }]
}

Ejemplo de respuesta

{
    "success": true,
    "material_id": 2051
}

Errores

Error Motivo
No name in input Falta un campo obligatorio (en lugar de name, el nombre del campo)
Name must not be empty Nombre vacío
Unit not found Unidad de medida desconocida, o una unidad solo para recursos
Storage ID not found Almacén no encontrado o eliminado
Invalid price value. Must be a number El valor no es un número, p. ej. "12,5" (igual para stock y minimum)
Category 12 not found Categoría no encontrada
Supplier not found or access denied Proveedor no encontrado o eliminado