POST/api/mod/ventas/{espacio}/inventory/upload

Carga el inventario desde un archivo

Subes tu hoja de existencias y cada fila fija la cantidad de su artículo. A diferencia de las tarifas, no hay borrador: entra directo y el agente la usa desde el siguiente mensaje.

PERMISOescribe
CRÉDITOSno gasta
AUTENTICACIÓNBearer bth_…

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.

CUERPO · MULTIPART/FORM-DATA

CAMPO	TIPO	REQUERIDO	QUÉ ES
file	archivo	SÍ	CSV, XLSX o PDF, hasta 10 MB, con una columna de cantidad y otra de nombre o SKU. Las columnas que reconoce, en la guía.

RESPUESTA 201

CAMPO	TIPO	QUÉ ES
items_cargados	integer	Los artículos que se crearon o actualizaron.
items_incompletos	[{ nombre, sku, warnings }]	Las filas que no entraron: sin cantidad legible.
warnings	string[]	Avisos del archivo entero, como «no se reconoció una tabla de stock».
origen · sha256	string	El tipo de archivo y su huella.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

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.
400	El archivo no es CSV, XLSX o PDF	extensión no soportada para inventario.
400	El archivo llegó vacío	archivo vacío.
413	El archivo pasa de 10 MB	archivo demasiado grande (máximo … bytes).
429	El espacio mandó demasiadas peticiones seguidas: espera unos segundos	Demasiadas solicitudes; intenta en un momento.

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

CONVIENE SABER

Los artículos que no vienen en el archivo no cambian. La cantidad del archivo reemplaza la que había (no se suma).
Si una fila no trae SKU, el SKU es su nombre en minúsculas con guiones.
Si el stock lo lleva el módulo Productos (inventario_delegado), carga allí tu inventario: el agente no mira este.