GET/api/mod/productos/{espacio}/inventory/items/{variante}

El stock de una variante

Las existencias de una variante en una bodega y, si las pides, sus últimos movimientos.

PARÁMETROS

CAMPO	TIPO	REQUERIDO	QUÉ ES
espacio	string	SÍ	El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Productos.
variante	string	SÍ	El id de la variante: sale en variantes[] del producto (32 caracteres hexadecimales).
bodega	string, query	no	La bodega. Por defecto, la única (texto vacío).
with_movements	bool, query	no	Trae sus últimos 50 movimientos. Por defecto false.

CAMPO	TIPO	QUÉ ES
variant_id	string	La variante.
bodega	string	La bodega. Texto vacío: la única.
stocked	string	Las existencias físicas.
reserved	string	Lo retenido por reservas activas. Disponible = stocked − reserved.
umbral_bajo	string \| null	Desde dónde cuenta como stock bajo.
unidad · external_id	string \| null	La unidad (unidad, kg, caja…) y su id en tu software contable.
created_at · updated_at	number	Segundos desde 1970, con decimales.
movements[]	{ tipo, delta, resultante, motivo, origen, created_at }	El más reciente primero: qué lo movió (ver tipos), cuánto, lo disponible después y por qué.

CAMPO	TIPO	QUÉ ES
set	a mano	Existencias fijadas con Fijar stock.
ajuste	a mano	Una reposición o una merma (delta).
ingesta	archivo	Cargado al subir un archivo de stock.
sync	contable	Traído de tu software contable.
venta	venta	Descontado por una venta confirmada.
reserva · liberacion	reserva	Una reserva retiene stock o lo devuelve.

STATUS	CUÁNDO	DETAIL LITERAL
403	El espacio no tiene el módulo Productos	módulo no habilitado para este espacio.
404	La variante no tiene stock cargado en esa bodega	nivel de stock no encontrado.

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.