---
title: Importar productos
description: 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](./products) 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](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgObeFKMJCcW62zHrU8smjSnqvixd1twlAf4uK)

## Controles principales

| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Importar** | Abre el flujo de trabajo de importación masiva | Abre el diálogo Importar productos sin iniciar una tarea. |
| **Plantilla** | Comienza con las columnas esperadas de Runner | Descarga el archivo `product-import-template.csv` actual. |
| **Historial** | Verifica tareas de importación anteriores | Cambia a una lista de archivos de importación y sus estados más recientes. |
| Área de carga | Elige el CSV preparado | Lee el archivo localmente y lo muestra como listo cuando el contenido está disponible. |
| Control de eliminar archivo | Corrige una selección incorrecta | Limpia el archivo seleccionado para que puedas elegir otro. |
| **Iniciar importación** | Envía el CSV seleccionado | Inicia una tarea de importación, luego se mueve al Historial cuando Runner la acepta. |
| **Cancelar** | Sal sin enviar | Cierra el diálogo y limpia el archivo seleccionado. |
| **Actualizar** en Historial | Solicita el estado de tarea más reciente | Recarga el historial de importación visible. |
| **Volver a Importar** | Prepara otro archivo | Vuelve de Historial a la vista de carga. |
| **Cerrar** | Sal de Historial | Cierra 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

| Estado | Significado | Qué hacer |
| --- | --- | --- |
| **Pendiente** | La tarea está esperando para comenzar | Déjala en su lugar y verifica más tarde; no envíes inmediatamente un duplicado. |
| **Procesando** | Runner está trabajando a través del archivo | Mantén el diálogo abierto o vuelve al Historial más tarde. |
| **Completado** | Runner terminó de entregar el archivo al importador de catálogo | El procesamiento de producto puede continuar después de este estado. Actualiza Productos e inspecciona nombres, variantes, precios, estado e inventario. |
| **Fallido** | Runner no pudo terminar la tarea de importación | La 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. |
| **Cancelado** | La 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

- [Productos](./products)
- [Inventario y variantes](./inventory-and-variants)
- [Incorporación y Configuración general](./onboarding-and-general-settings)
- [Descripción general de Operaciones de tienda](./)