StockAI no acepta mi archivo

Qué significa cada aviso al subir ventas o inventario, por qué aparece y qué cambiar en el archivo para que entre.

Casi todos los rechazos tienen arreglo en el propio archivo. Busca abajo el mensaje que ves; cada uno trae qué significa y qué hacer.

Formato no soportado

Lo que ves: «No podemos leer archivos .pdf. Sube uno de estos formatos: …» (con la extensión de tu archivo).

Por qué: las ventas se aceptan en CSV, Excel (.xlsx, .xls), Parquet y JSON. Un PDF, una imagen o un archivo comprimido no se pueden leer como tabla.

Qué hacer: exporta el reporte desde tu sistema como CSV o Excel. Si no sabes por dónde empezar, descarga la plantilla: sus columnas son sku, fecha, demanda, tienda, inventario, costo y precio, y solo las tres primeras son obligatorias.

El archivo pesa demasiado

Lo que ves: «El archivo pesa … MB y el máximo es … MB. Sube uno más liviano o divídelo en varios.»

Por qué: en el plan gratis cada archivo puede pesar hasta 25 MB; en el plan completo, hasta 100 MB; en el corporativo, hasta 2000 MB. Ver Límites de los planes.

Qué hacer: quita columnas que StockAI no usa (descripciones largas, direcciones, notas), guárdalo como CSV en vez de Excel, que pesa menos, o súbelo en partes. Si tu historial de verdad no cabe, escríbenos desde el aviso.

El archivo está vacío

Lo que ves: «El archivo de «…» está vacío o no tiene columnas. Sube un CSV con encabezado y datos.» En el importador de inventario: «No pudimos usar ninguna fila del archivo. Revisa que tenga una columna con el código del producto.»

Por qué: el archivo no tiene fila de encabezado, no tiene filas de datos, o ninguna fila trae el código del producto.

Qué hacer: ábrelo y comprueba que la primera fila sean los nombres de las columnas y que debajo haya datos. Si tu sistema exporta un título o un logo encima de la tabla, bórralo.

No se puede leer

Lo que ves: «No pudimos leer el archivo que subiste. Revisa que sea un CSV o Excel válido y vuelve a intentarlo.» En inventario: «No pudimos abrir el archivo como hoja de cálculo. Vuelve a exportarlo en .xlsx o .csv.»

Por qué: el archivo está dañado, se cortó al descargarlo, o tiene una extensión que no corresponde a su contenido (por ejemplo, un HTML renombrado a .xls, que es como algunos sistemas «exportan a Excel»).

Qué hacer: vuelve a exportarlo desde tu sistema, ábrelo en tu hoja de cálculo para confirmar que se ve bien, y guárdalo de nuevo como .xlsx o .csv.

El archivo contiene un byte NUL

Lo que ves: un aviso de que el archivo no se pudo leer, con el detalle técnico en inglés: «The file contains a NUL byte (first seen on line N). Rows containing one cannot be imported, because the value would be silently truncated. Re-export the file from your system.»

Por qué: un byte NUL es un carácter invisible (código cero) que no debería estar en un archivo de texto. Suele aparecer cuando un sistema exporta en una codificación rara, cuando el archivo quedó a medio escribir, o cuando se copió desde una base de datos que guarda campos de largo fijo. Si StockAI lo dejara pasar, el valor de esa celda se cortaría sin avisar, así que prefiere rechazarlo. El número de línea te dice dónde aparece el primero.

Qué hacer: vuelve a exportar el archivo desde tu sistema, de preferencia como CSV en UTF-8. Si el problema sigue, ábrelo en tu hoja de cálculo y guárdalo con «Guardar como» CSV: eso descarta los caracteres invisibles. En el importador de inventario no se rechaza el archivo entero: las filas con un byte NUL se saltan y se cuentan entre las que quedan fuera.

«1.250»: ¿mil doscientos cincuenta o uno coma veinticinco?

Lo que ves: en el importador de inventario, la pregunta «Tu archivo escribe números como 1.250. ¿Cuánto es?»; al subir ventas, el hallazgo «No sabemos si la coma separa miles o decimales».

Por qué: en América Latina «1.250» suele ser mil doscientos cincuenta; en un sistema configurado en inglés, uno coma veinticinco. Si nada en el archivo lo aclara, StockAI no adivina: un stock de 1250 leído como 1,25 pone en rojo una bodega llena.

Qué hacer: elige la opción que corresponde a tu sistema. Si no estás seguro, busca en el archivo un número que conozcas, como el stock de un producto que contaste ayer. Si tu integración sube el inventario por la API, la respuesta es un 422 con el código inventory_import_number_format_unclear: «Tu archivo escribe números como …, y nada en él dice si eso es … o …. Súbelo desde Configurar inventario para elegir, o arréglalo en tu sistema.» La integración puede responder la pregunta indicando el formato en la llamada (ver la referencia).

Filas que quedan fuera del inventario

Lo que ves: en el resumen del importador, «Filas con problemas que quedan fuera: …» y «Filas sin código de producto que se saltan: …», con ejemplos del tipo «Fila 214 (SKU-001): "N/D"».

Por qué: una fila sin código de producto no se puede asignar a nada. Una fila con texto donde va un número («N/D», «agotado»), con stock o costo negativos, o con un byte NUL, se deja fuera en vez de inventar un valor. Si un producto aparece varias veces, se queda el valor de la última fila.

Qué hacer: corrige las filas que te nombra el resumen y vuelve a importar. Si ya corregiste algunos productos a mano en StockAI, marca «No sobrescribir lo que corregí a mano» para que el archivo solo llene lo que falta.

Tienes que decidir algo antes de seguir

Lo que ves: al confirmar las columnas de tus ventas, el bloque «Tienes que decidir algo antes de seguir», con el botón de continuar apagado. Si intentas entrenar igual: «Antes de entrenar tienes que decidir qué hacer con los problemas que encontramos en el archivo…».

Por qué: el control de datos encontró algo que cambiaría el pronóstico sin avisarte, como fechas que pueden ser día/mes o mes/día, o una coma que puede ser de miles o de decimales.

Qué hacer: responde cada pregunta. Cada opción dice qué hace y qué te cuesta si te equivocas; la marcada como recomendada es solo una sugerencia. Cuando no quede ninguna sin responder, el botón se enciende solo.

Si el mensaje es «Este archivo no puede generar un pronóstico, y no hay corrección que lo cambie. Revisa el archivo y vuelve a subirlo.», no hay pregunta que lo arregle: suele ser un mapeo de columnas equivocado (por ejemplo, la columna de cantidad apunta a un texto). Corrige el mapeo o sube otro archivo.

Productos que no aparecen después de entrenar

Lo que ves: en Inventario, el aviso de que algunos productos subidos no se incluyeron en el pronóstico, con el motivo «Solo … registros de historia (se necesitan al menos 20)».

Por qué: un producto necesita al menos 20 períodos de historia para entrar al pronóstico. Con menos no se puede medir si un modelo acierta, así que se deja fuera en lugar de darte un pronóstico sin respaldo.

Qué hacer: si el producto es nuevo, espera a tener más historia. Si tienes historia más vieja en otro archivo, súbela junta. Si vendes poco cada día, prueba un detalle semanal o mensual: ver Granularidad. Estos productos no afectan al resto de tus recomendaciones.