Qué podés importar
La pantalla Importar / exportar trabaja con tres tipos de datos:
- Productos;
- Categorías;
- Marcas.
Cada bloque tiene su propia plantilla, importación y exportación.
Antes de importar
Podés:
- descargar una plantilla vacía;
- exportar el catálogo actual;
- editar el CSV;
- subir el archivo o pegar el contenido en el editor;
- ejecutar la importación.
La pantalla muestra además la cabecera esperada para cada CSV.
Productos
El CSV de productos acepta categoría y marca por nombre mediante las columnas correspondientes. La pantalla informa que esas entidades se crean si todavía no existen.
El identificador web se genera a partir del nombre. Para actualizar filas existentes, la pantalla recomienda incluir la columna de ID y obtenerla previamente mediante una exportación.
Procesamiento por lotes
Los productos no se envían todos en un único request cuando el archivo es grande.
Structura divide la importación en lotes de 150 filas y muestra progreso real.
Durante el proceso podés ver:
- cuántas filas fueron procesadas;
- cuántas faltan;
- creados acumulados;
- actualizados acumulados;
- errores de filas.
Esto evita que un archivo grande dependa de una sola ejecución y permite identificar hasta dónde llegó una importación interrumpida.
Si falla un lote
Si el servidor rechaza un lote, la pantalla informa la fila aproximada en la que se interrumpió y cuántos productos alcanzaron a crearse o actualizarse antes del fallo.
Si se corta realmente la red, informa cuántas filas se procesaron antes de perder la conexión.
No confundas ambos casos: un rechazo del servidor y una desconexión requieren diagnósticos diferentes.
Errores de filas
Una importación puede terminar correctamente y aun así devolver filas con error.
La pantalla informa la cantidad de filas afectadas y muestra una muestra de los primeros mensajes para facilitar la corrección del CSV.
Categorías
La plantilla de categorías contempla parent_id opcional.
La pantalla indica que no necesitás incluir slug manualmente: se asigna automáticamente.
La exportación es útil si necesitás conservar IDs y reconstruir relaciones o editar categorías existentes.
Marcas
La plantilla de marcas utiliza el nombre como dato obligatorio.
La exportación incluye id y slug, por lo que es especialmente útil cuando vas a hacer ediciones masivas sobre marcas ya existentes.
Subir un archivo
Elegí Subir .csv y seleccioná el archivo. Structura lee el contenido localmente y lo coloca en el editor de texto antes de ejecutar la importación.
También podés pegar directamente el CSV en el área de texto.
Importar no es lo mismo que validar visualmente
Antes de ejecutar una importación grande, revisá:
- encabezados;
- separadores y formato CSV;
- nombres de categorías y marcas;
- IDs cuando estás actualizando;
- columnas que podrían crear entidades nuevas;
- y cantidad de filas.
Después de importar, revisá el resultado desde Productos o desde el módulo específico que corresponda.
Exportar
Cada bloque tiene Exportar actual. La exportación consulta los datos actuales del comercio y descarga un CSV.
Es la herramienta recomendada para obtener IDs antes de preparar actualizaciones masivas sobre datos existentes.
Qué hacer después de una importación
No des por terminado el proceso solamente porque apareció el mensaje de éxito.
- Revisá creados y actualizados.
- Revisá si hubo filas con error.
- Abrí algunos productos reales.
- Verificá categorías y marcas.
- Si cambiaste precios, stock o datos comerciales, comprobá el resultado en el catálogo y en la operación donde se utilizan.