Crea un producto junto con sus componentes. El producto aparece en el almacén storage_id y en los almacenes que guardan todos los productos o sus categorías.

```
v1/products/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 de venta por unidad. Por defecto 0 |
| batch_size | float | No | Tamaño del lote: la cantidad de producto para la que se indican los componentes. Por defecto 1 |
| 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 | ID de proveedores de [v1/suppliers/get_list](https://developers.controlata.com/hc/api-docs/articles/api-suppliers-get-list-es) |
| alternative_sku | array | No | SKU alternativos: objetos con sku y label (una etiqueta opcional) |
| materials | array | No | Materiales en los componentes |
| products | array | No | Semielaborados en los componentes |
| resources | array | No | Recursos en los componentes |

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

La unicidad del SKU principal y de los alternativos no se comprueba.

## Componentes del producto

Los componentes se definen por lote (batch_size unidades) y se envían en los array materials (materiales), products (semielaborados) y resources (recursos).

### Líneas materials y products

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | int | Sí | ID del material o del producto |
| amount_per_batch | float | Sí | Cantidad por lote |
| unit | string | Sí | Unidad de la línea. Del mismo grupo que la unidad del material o del producto: para un material en «kg» valen «kg» o «g» |
| loss_percent | float | No | Pérdidas, en porcentaje. Por defecto 0. Se aceptan solo si en los ajustes de la empresa está activada la visualización de pérdidas en los componentes |
| position | int | No | Posición de la línea en los componentes |

position fija el orden de las líneas de componentes en la interfaz de Controlata, común para materials y products. Las líneas sin este campo van al final, en el orden enviado. Controlata renumera las posiciones desde 0, por lo que en [Obtener los datos de un producto](https://developers.controlata.com/hc/api-docs/articles/api-products-get-entry-es) pueden diferir de las enviadas.

### Líneas resources

Cada línea de recurso contiene el id del recurso. Si hacen falta amount_per_batch y unit depende del tipo de recurso (consulta [Crear un recurso](https://developers.controlata.com/hc/api-docs/articles/api-resources-add-es)):

| Tipo de recurso | amount_per_batch | unit |
|---|---|---|
| Tarifa fija | Cantidad por lote, p. ej. horas de trabajo | Necesario |
| Tarifa fija, el precio se indica en los componentes del producto | Un importe por lote | No necesario |
| Porcentaje | No se envía: se toma del recurso | No necesario |
| Porcentaje, se indica en los componentes del producto | El porcentaje | No necesario |
| Amortización | Cantidad por lote, p. ej. horas de uso del equipo | Necesario |

## Ejemplo de solicitud

Una mesa: 10 por lote, cada lote usa 0.5 m3 de tablero con un 5 % de pérdidas, 400 tornillos, 40 patas (un semielaborado) y 30 horas de trabajo del carpintero. Los gastos generales son un porcentaje fijado en el propio recurso, así que basta con su id.

```
{
    "name": "Mesa de comedor",
    "sku": "P100",
    "unit": "ud",
    "price": 45000,
    "batch_size": 10,
    "storage_id": 3999,
    "stock": 5,
    "minimum": 2,
    "categories": [{ "id": 21 }],
    "suppliers": [{ "id": 46 }],
    "alternative_sku": [
        {
            "label": "Shopify",
            "sku": "SH-P100"
        }
    ],
    "materials": [
        {
            "id": 2051,
            "amount_per_batch": 0.5,
            "unit": "m3",
            "loss_percent": 5
        },
        {
            "id": 2060,
            "amount_per_batch": 400,
            "unit": "ud"
        }
    ],
    "products": [
        {
            "id": 312,
            "amount_per_batch": 40,
            "unit": "ud"
        }
    ],
    "resources": [
        {
            "id": 57,
            "amount_per_batch": 30,
            "unit": "h"
        },
        {
            "id": 58
        }
    ]
}
```

## Ejemplo de respuesta

```
{
    "success": true,
    "product_id": 3120
}
```

## 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 |
| Name must be a string | El nombre no se envió como cadena, p. ej. como array |
| Unit not set | Se envió una unidad de medida vacía |
| Unit not found | Unidad de medida desconocida, o una unidad solo para recursos |
| Storage ID is not set | storage_id es 0 o está vacío |
| Storage ID not found | Almacén no encontrado o eliminado |
| Batch size must be greater than 0 | El tamaño del lote es 0 o menor |
| Invalid price value. Must be a number | El valor no es un número, p. ej. "12,5" (igual para batch_size, stock y minimum) |
| Category 12 not found | Categoría no encontrada |
| Supplier not found or access denied | Proveedor no encontrado o eliminado |
| Alternative_sku is not an array | alternative_sku no se envió como array |
| SKU must be from 1 to 50 characters for alternative_sku 0 | El SKU alternativo está vacío o supera los 50 caracteres (al final, el número de línea desde 0) |
| Label must not exceed 100 characters for alternative_sku 0 | La etiqueta del SKU alternativo supera los 100 caracteres |

### Errores en las líneas de componentes

En el texto del error, en lugar de 2051 aparece el ID del elemento, y en lugar de 0 el número de línea en el array (desde 0).

| Error | Motivo |
|---|---|
| Materials is not an array | materials no se envió como array (igual para products y resources) |
| Line 0 of materials must be an object | La línea no es un objeto (igual para products y resources) |
| No id for material 0 | Falta el id del material o no es un número (igual para product) |
| Material 2051 not found | Material no encontrado o eliminado |
| Product 2051 not found | Producto no encontrado o eliminado |
| Product cannot be a component of itself | El producto se añadió a sus propios componentes |
| Amount per batch must be greater than 0 for material 2051 | La cantidad falta, no es un número, o es 0 tras redondear a 3 decimales (igual para product y resource) |
| Unit not found for material 2051. Use a unit of the same group as the material unit | La unidad falta, es desconocida o de otro grupo (igual para product) |
| Loss percent must be from 0 to 100 for material 2051 | Las pérdidas son menores que 0, mayores que 100 o no son un número (igual para product) |
| Loss percent is disabled in company settings for material 2051 | Se enviaron pérdidas, pero en los ajustes de la empresa está desactivada su visualización en los componentes (igual para product) |
| Resource for line 0 not found | Recurso no encontrado o eliminado |
| Percent must not exceed 100 for resource 2051 | El porcentaje en los componentes supera 100 |
| Unit not found for resource 2051. Use a unit of the same group as the resource unit | La unidad del recurso falta, es desconocida o de otro grupo |
