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.
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 |
| 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) |
| 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 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).