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 |