GET/api/mod/productos/{espacio}/inventory/availability

La disponibilidad de una variante

Si hay stock para una cantidad, por variant_id o por SKU. Descuenta lo reservado y, en un combo, mira su componente más escaso.

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.
variant_id	string, query	UNO DE LOS DOS	La variante.
sku	string, query	UNO DE LOS DOS	O su SKU.
cantidad	string, query	no	Cuántas quieres. Por defecto 1.
bodega	string, query	no	La bodega. Por defecto, la única (texto vacío).

CAMPO	TIPO	QUÉ ES
estado	string	Ver estados.
variant_id · sku · nombre	string \| null	La variante y su producto.
cantidad_disponible	string \| null	Lo que se puede vender ya. null si no hay dato.
cantidad_pedida	string \| null	La que preguntaste.
unidad	string \| null	La unidad del stock.

CAMPO	TIPO	QUÉ ES
disponible	se puede vender	Alcanza para la cantidad pedida.
stock_bajo	se puede vender	Alcanza, pero lo disponible queda en o bajo umbral_bajo.
insuficiente	no alcanza	Hay, pero menos de lo pedido.
agotado	no alcanza	Lo disponible es 0.
no_rastreado	sin dato	La variante no existe o no tiene stock cargado en esa bodega. No es un no: decide tú.
inventario_inactivo	sin dato	El espacio no controla stock (inventario_activo: false en la configuración).

STATUS	CUÁNDO	DETAIL LITERAL
403	El espacio no tiene el módulo Productos	módulo no habilitado para este espacio.
400	No viene ni variant_id ni sku	indique variant_id o sku.

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

Se puede vender con disponible y stock_bajo. Para apartarlo mientras tu cliente paga, resérvalo.