POST/api/mod/productos/{espacio}/inventory/items

Fija el stock de una variante

Pone las existencias físicas de una variante en una bodega: el número que cuentas en el estante. Si no tenía stock cargado, lo crea.

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.

CAMPO	TIPO	REQUERIDO	QUÉ ES
variant_id	string	SÍ	La variante.
stocked	number \| string	SÍ	Las existencias, en absoluto. Admite decimales (kg, litros).
bodega	string	no	Por defecto, la única.
umbral_bajo	number \| string	no	Desde dónde avisa de stock bajo.
unidad	string	no	unidad, kg, caja…
external_id	string	no	Su id en tu software contable.

El stock, ya fijado.

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.

STATUS	CUÁNDO	DETAIL LITERAL
403	El espacio no tiene el módulo Productos	módulo no habilitado para este espacio.
403	La clave es de solo lectura	Tu cuenta es de solo lectura en este espacio.
422	Falta un campo obligatorio o uno no es de su tipo (detail es una lista)	—

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

No toca lo reservado: disponible sigue siendo stocked − reserved.
umbral_bajo, unidad y external_id en null dejan el valor que había. No comprueba que la variante exista.
Para sumar o restar en vez de fijar, ajusta.
Las cantidades y los importes viajan como texto decimal ("32000", "1.5") para no perder precisión. Al mandarlos vale un número o un texto.