Devuelve los datos de un producto, sus existencias en un almacén y sus componentes.

```
v2/products/get_entry.php
```

## Parámetros

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_id | int | Sí | ID del producto |
| storage_id | int | Sí | ID del almacén |

El producto se devuelve solo si figura en el almacén storage_id. Las existencias en todos los almacenes a la vez las devuelve [v1/products/get_stocks](https://developers.controlata.com/hc/api-docs/articles/api-products-get-stocks-es).

## Respuesta

Un objeto product con los campos del producto, sus existencias en el almacén storage_id, sus categorías, proveedores, SKU alternativos y componentes.

| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID del producto |
| name | string | Nombre |
| sku | string | SKU |
| unit | string | Unidad de medida, un código de [Unidades de medida](https://developers.controlata.com/hc/api-docs/articles/api-units-get-list-es) |
| price | float | Precio de venta por unidad |
| cost | float | Coste por unidad |
| batch_size | float | Tamaño del lote: la cantidad de producto para la que se indican los componentes |
| notes | string | Notas |
| archived | int | 1 si el producto está archivado |
| stock | float | Existencias en el almacén storage_id |
| minimum | float | Existencias mínimas en el almacén storage_id |
| planned | float | Cambio de existencias por operaciones en estado Planificado. null si no hay ninguna |
| categories | array | Categorías del producto: objetos con id y name |
| suppliers | array | Proveedores del producto: objetos con id y name |
| alternative_sku | array | SKU alternativos: objetos con label y sku |

Además de estos campos, el objeto contiene los componentes:

| Campo | Tipo | Descripción |
|---|---|---|
| materials | array | Materiales en los componentes |
| products | array | Semielaborados en los componentes |
| resources | array | Recursos en los componentes |

Campos de las líneas materials, products y resources:

| Campo | Descripción |
|---|---|
| id | ID del material, producto o recurso |
| name | Nombre |
| sku | SKU. Solo en materiales y semielaborados |
| type | Tipo de cálculo del recurso. Solo en recursos (consulta [Crear un recurso](https://developers.controlata.com/hc/api-docs/articles/api-resources-add-es)) |
| dynamic | 1 si el precio o el porcentaje se indica en los componentes del producto. Solo en recursos |
| base | Base de cálculo de un recurso porcentual: cost o price. Solo en recursos |
| amount_per_batch | Cantidad por lote |
| amount_per_unit | Cantidad por unidad de producto: amount_per_batch / batch_size |
| loss_percent | Pérdidas, en porcentaje. Solo en materiales y semielaborados |
| unit | Unidad de medida. «%» en un recurso porcentual |
| cost_per_unit | Coste de la línea por unidad de producto |
| cost_per_batch | Coste de la línea por lote |
| position | Posición de la línea: común para materials y products, aparte para resources |

En un recurso del tipo tarifa fija con su precio en los componentes del producto, amount_per_batch contiene un importe, no una cantidad.

cost_per_unit y cost_per_batch tienen en cuenta las pérdidas cuando loss_percent > 0.

Las líneas de componentes, las categorías y los proveedores de la respuesta se pueden enviar a [v1/products/edit](https://developers.controlata.com/hc/api-docs/articles/api-products-edit-es) sin cambios.

## Ejemplo de solicitud

```
{
    "product_id": 3120,
    "storage_id": 3999
}
```

## Ejemplo de respuesta

```
{
    "success": true,
    "product": {
        "id": 3120,
        "name": "Mesa de comedor",
        "sku": "P100",
        "price": 45000,
        "cost": 13604.25,
        "batch_size": 10,
        "notes": "",
        "archived": 0,
        "stock": 12,
        "minimum": 3,
        "planned": null,
        "unit": "ud",
        "categories": [
            {
                "id": 21,
                "name": "Muebles"
            }
        ],
        "alternative_sku": [
            {
                "label": "Shopify",
                "sku": "SH-P100"
            }
        ],
        "suppliers": [
            {
                "id": 46,
                "name": "Mueblería S.L."
            }
        ],
        "materials": [
            {
                "id": 2051,
                "name": "Tablón de roble",
                "sku": "M010",
                "amount_per_unit": 0.05,
                "amount_per_batch": 0.5,
                "loss_percent": 5,
                "unit": "m3",
                "cost_per_unit": 7087.5,
                "cost_per_batch": 70875,
                "position": 0
            },
            {
                "id": 2060,
                "name": "Tornillo 4x40",
                "sku": "M024",
                "amount_per_unit": 40,
                "amount_per_batch": 400,
                "loss_percent": 0,
                "unit": "ud",
                "cost_per_unit": 80,
                "cost_per_batch": 800,
                "position": 1
            }
        ],
        "products": [
            {
                "id": 312,
                "name": "Pata de mesa",
                "sku": "P012",
                "amount_per_unit": 4,
                "amount_per_batch": 40,
                "loss_percent": 0,
                "unit": "ud",
                "cost_per_unit": 3400,
                "cost_per_batch": 34000,
                "position": 2
            }
        ],
        "resources": [
            {
                "id": 57,
                "name": "Trabajo del carpintero",
                "type": "rate",
                "dynamic": 0,
                "base": null,
                "amount_per_unit": 3,
                "amount_per_batch": 30,
                "unit": "h",
                "cost_per_unit": 1800,
                "cost_per_batch": 18000,
                "position": 0
            },
            {
                "id": 58,
                "name": "Gastos generales",
                "type": "percent",
                "dynamic": 0,
                "base": "cost",
                "amount_per_unit": 10,
                "amount_per_batch": 10,
                "unit": "%",
                "cost_per_unit": 1236.75,
                "cost_per_batch": 12367.5,
                "position": 1
            }
        ]
    }
}
```

## Errores

| Error | Motivo |
|---|---|
| No product_id in input | Falta un campo obligatorio (en lugar de product_id, el nombre del campo) |
| Storage ID not found | Almacén no encontrado o eliminado |
| Product not found or access denied | Producto no encontrado, eliminado o que no figura en el almacén |

## Versión v1

El método v1/products/get_entry acepta los mismos parámetros y devuelve los mismos campos del producto. Solo cambia la representación de los componentes, así que usa v2 en las integraciones nuevas.

| Qué | v1 | v2 |
|---|---|---|
| Componentes | Un solo array components: materiales y semielaborados juntos | Arrays separados materials, products y resources |
| id en las líneas de componentes | Con prefijo: «m-123» para un material, «p-45» para un semielaborado | id numérico del elemento |
| Reenviar líneas a add y edit | No se puede sin cambios, los id con prefijo estorban | Se puede tal cual |

Además, v1 devuelve campos internos que v2 omite: product.status y el status de las líneas de componentes (siempre 1) y product.percent (se calcula a partir de cost y price).
