Obtener los datos de un producto

Maxim

Maxim

Última actualización el Oct 8, 2026

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