Runner AI
DocumentaciónOperaciones de tienda

Importar productos

Usa la plantilla CSV de Runner para iniciar una importación de catálogo y sigue su historial de procesamiento.

Importa productos desde un CSV preparado cuando ingresar la misma información de catálogo estructurada uno a uno sería ineficiente.

Por qué y cuándo usar importación

Usa Importar cuando ya tienes datos de producto en una hoja de cálculo u otro sistema y puedes asignarlos a la plantilla CSV de Runner. Usa el formulario manual Productos para un catálogo pequeño o cuando necesites aprender los campos primero.

Disponibilidad y requisitos previos

  • Abre Operaciones de tienda → Productos en una tienda lista.
  • Completa la configuración de publicación/preparación de la tienda que crea su canal de catálogo de tienda en vivo; la tarea de importación no puede continuar sin ese canal.
  • La lista de productos de escritorio poblada muestra Importar. En un catálogo vacío, primero usa Añadir primer producto; la vista móvil enfatiza la creación manual.
  • Importar acepta solo archivos CSV.
  • Usa la Plantilla actual de Runner. Las columnas requeridas son handle y title; las filas de variantes deben incluir el sku requerido y los valores de opción mostrados por la plantilla.
  • Iniciar una importación cambia el catálogo de la tienda. Revisa el archivo antes de enviarlo.

Abrir Importar productos

Ruta de entrada: Espacio de trabajo → elige una tienda → Operaciones de tienda → Productos → Importar

Diálogo Importar productos

Controles principales

ControlPor qué lo usasQué sucede cuando se selecciona
ImportarAbre el flujo de trabajo de importación masivaAbre el diálogo Importar productos sin iniciar una tarea.
PlantillaComienza con las columnas esperadas de RunnerDescarga el archivo product-import-template.csv actual.
HistorialVerifica tareas de importación anterioresCambia a una lista de archivos de importación y sus estados más recientes.
Área de cargaElige el CSV preparadoLee el archivo localmente y lo muestra como listo cuando el contenido está disponible.
Control de eliminar archivoCorrige una selección incorrectaLimpia el archivo seleccionado para que puedas elegir otro.
Iniciar importaciónEnvía el CSV seleccionadoInicia una tarea de importación, luego se mueve al Historial cuando Runner la acepta.
CancelarSal sin enviarCierra el diálogo y limpia el archivo seleccionado.
Actualizar en HistorialSolicita el estado de tarea más recienteRecarga el historial de importación visible.
Volver a ImportarPrepara otro archivoVuelve de Historial a la vista de carga.
CerrarSal de HistorialCierra el diálogo sin cambiar la tarea ya enviada.

Prepara y envía un CSV

  1. Selecciona Importar, luego Plantilla.
  2. Abre el CSV descargado en un editor de hojas de cálculo que preserve el formato CSV.
  3. Mantén los encabezados de plantilla. Completa handle y title para productos, más el sku mostrado y valores de opción para variantes.
  4. Revisa identificadores de producto, títulos, precios, variantes y cualquier fila repetida antes de exportar como CSV.
  5. Vuelve al diálogo y elige o arrastra el CSV al área de carga.
  6. Espera hasta que el archivo muestre Listo para importar.
  7. Selecciona Iniciar importación una sola vez.
  8. En Historial, sigue el archivo enviado hasta que alcance un estado terminal, luego actualiza la lista de Productos e inspecciona las filas resultantes.

Comprende los estados del Historial

EstadoSignificadoQué hacer
PendienteLa tarea está esperando para comenzarDéjala en su lugar y verifica más tarde; no envíes inmediatamente un duplicado.
ProcesandoRunner está trabajando a través del archivoMantén el diálogo abierto o vuelve al Historial más tarde.
CompletadoRunner terminó de entregar el archivo al importador de catálogoEl procesamiento de producto puede continuar después de este estado. Actualiza Productos e inspecciona nombres, variantes, precios, estado e inventario.
FallidoRunner no pudo terminar la tarea de importaciónLa tarjeta de Historial actual registra el estado fallido pero no una causa detallada. Verifica los requisitos previos y CSV de origen antes de enviar un nuevo archivo.
CanceladoLa tarea no continuóConfirma si se crearon productos antes de decidir qué enviar a continuación.

El Historial también puede mostrar el tamaño del archivo, filas totales e ID de transacción cuando Runner tiene esos valores. Estos detalles identifican la tarea; no reemplazan la verificación de los registros de producto.

Límites y solución de problemas

  • Iniciar importación está deshabilitado: Selecciona un archivo .csv y espera a que Runner termine de leer contenido no vacío.
  • Tipo de archivo inválido: Exporta la hoja de cálculo como CSV; renombrar otro formato de archivo no lo convierte.
  • Error de lectura de archivo: Re-exporta el CSV, confirma que se abre normalmente en tu dispositivo y elige de nuevo.
  • Importación fallida: Confirma que la configuración de publicación/preparación de la tienda creó el canal de catálogo de tienda en vivo, luego usa la plantilla proporcionada, restaura columnas requeridas y verifica variante sku y valores de opción.
  • La tarea parece atascada: Abre Historial y selecciona Actualizar. Pendiente y Procesando no son prueba de finalización.
  • Aparecen filas de producto inesperadas: No repitas la misma importación ciegamente. Compara los identificadores de CSV con la lista de Productos y corrige registros deliberadamente.

Guías relacionadas