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

Ajusta el stock de una variante

Suma o resta existencias: una reposición (+), una merma o una rotura (−).

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

CAMPO	TIPO	REQUERIDO	QUÉ ES
delta	number \| string	SÍ	Cuánto sumar; en negativo, restar.
bodega	string	no	Por defecto, la única.
motivo	string	no	Queda en el movimiento: «reposición», «rotura».

El stock, ya ajustado.

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.
404	La variante no tiene stock cargado en esa bodega	nivel de stock no encontrado.
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.