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](https://developers.controlata.com/hc/api-docs/articles/api-units-get-list-es) |
| 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](https://developers.controlata.com/hc/api-docs/articles/api-categories-get-list-es) y [v1/suppliers/get_list](https://developers.controlata.com/hc/api-docs/articles/api-suppliers-get-list-es).

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 |
