PATCH/api/mod/ventas/{espacio}/inventory/items/{sku}

Ajusta la cantidad de un artículo

Suma o resta a la cantidad actual: una reposición, una merma, un conteo. Queda como movimiento de ajuste.

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 Ventas.
sku	string	SÍ	El SKU del artículo. Si no diste uno al cargarlo, es su nombre en minúsculas con guiones (Café Huila 500 g → cafe-huila-500-g).

CAMPO	TIPO	REQUERIDO	QUÉ ES
delta	string	SÍ	Lo que sumas, con signo, texto decimal: "24" o "-3".
motivo	string	no	Por qué: queda en el movimiento.

El artículo, con su cantidad nueva.

CAMPO	TIPO	QUÉ ES
sku · nombre	string	El SKU y el nombre.
cantidad	string	Lo que hay, como texto decimal ("12", "2.5"). Nunca baja de 0.
umbral_bajo	string \| null	Desde esta cantidad hacia abajo cuenta como stock bajo. null: sin umbral.
unidad · bodega	string \| null	La unidad (unidad, kg, caja…) y dónde está.
aliases_json	string	Otros nombres con los que se reconoce, como una lista JSON en texto: `"[\"Café Huila\"]"`.
activo	0 \| 1	1 si se ofrece.
fuente	string \| null	De dónde vino su última carga: csv, xlsx, pdf o manual.
external_id	string \| null	Su id en tu sistema contable, si viene de una sincronización.
created_at · updated_at	number	Segundos desde 1970, con decimales.

STATUS	CUÁNDO	DETAIL LITERAL
403	El espacio no tiene el módulo Ventas	módulo no habilitado para este espacio.
403	La clave es de solo lectura	Tu cuenta es de solo lectura en este espacio.
404	No hay un artículo con ese SKU en el inventario	item 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.

La cantidad nunca baja de 0: si restas más de lo que hay, queda en 0.
Las cantidades y los importes van como texto decimal ("12", "2.5"), no como número: un número da 422.