# Importar con archivos CSV

Use la importación CSV para crear o actualizar rápidamente productos (e inventario) en su tienda de Shopify mediante un archivo de hoja de cálculo.

## ✅ Antes de empezar (requisitos)

#### 📌 Prepare su archivo CSV

Asegúrese de que su CSV tenga:

* **Encabezados de columna** en la primera fila (p. ej.: `Handle`, `Title`, `Vendor`)
* Una **clave única** que pueda usar para hacer coincidir los registros (recomendado: **Handle**)
* Formato correcto (archivo CSV)

#### 🔑 Clave principal recomendada

* **Handle del producto (Product Handle)** (la mejor opción para la mayoría de las importaciones)
* También puede ver otras claves según sus datos (p. ej.: ID de producto, SKU de variante)

***

## 🛠️ Pasos para cargar el archivo&#x20;

### Abra Cargas de CSV (CSV Uploads) en la aplicación Tipo

<figure><img src="/media/2a19292f386ccfa6c516.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

1. En el panel de administración de Shopify, abra **Aplicaciones → Tipo Sync**
2. Haga clic en **Cargas de CSV (CSV uploads)**
3. Haga clic en **Agregar archivo CSV (Add csv file)**

Accederá al asistente de importación (**progreso 1/3**).

***

### 📤 Paso 1/3 — Cargar el CSV&#x20;

<figure><img src="/media/e3560f7f8a801b3726ec.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Elija el origen de la carga**

Puede cargar el CSV desde:

* **Importación de CSV (CSV Import)** (cargar un archivo desde su computadora)
* Importar desde un enlace web (URL) (Import from Web Link)
* Carga desde servidor FTP (FTP Server Upload)
* Carga desde servidor SFTP (SFTP Server Upload)

#### **Elija las opciones del CSV**

**Separador**

* Coma (el más común)
* Punto y coma
* Otro

**Datos del CSV**

* **Producto (Product)** (para campos de producto como título, descripción, proveedor…)
* **Inventario (Inventory)** (para cantidades de inventario)

Luego haga clic en **Siguiente paso (Next Step)**.

<figure><span class="missing-media" role="note">Esta captura de pantalla no está disponible en la documentación original.</span><figcaption></figcaption></figure>

***

### 🧩 Paso 2/3 — Asignar campos&#x20;

<figure><img src="/media/5beb2e9d9f197c6c8f0e.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

**A) Asignación de la clave principal (Primary Key)**

Esto le indica a la aplicación cómo hacer coincidir las filas de su CSV con los productos de Shopify.

* **Clave principal (Primary Key)**: elija por qué campo coincidirá su tienda de Shopify\
  Ejemplo: **Handle del producto**
* **Encabezado de columna (Column heading)**: elija la columna de su CSV\
  Ejemplo: **Handle**

> Si su clave principal no coincide, la aplicación puede crear duplicados o no actualizar el producto correcto.

**B) Asigne las columnas de su CSV a los campos de Shopify**

Verá pestañas como:

* **Producto (Product)**
* **Variante (Variant)**
* **Imagen (Image)**
* **Metacampo (Metafield)**
* **Inventario (Inventory)**

Para cada fila:

* **Importar a Shopify (Import to Shopify)** = campo de Shopify (p. ej.: Title)
* **Encabezado de columna** = columna del CSV (p. ej.: Title)

Puede hacer clic en **➕ Agregar asignación (Add mapping)** para importar más campos.

Luego haga clic en **Siguiente paso (Next Step)**.

***

### ⚙️ Paso 3/3 — Ajustes de importación&#x20;

<figure><img src="/media/0982d902faf55aaf2e59.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Paso 3.1. Coincidencia e importaciones (Matching & Imports): cómo actualizar Shopify**

Elija una:

✅ **Crear elementos nuevos (Create new items)**

* Solo crea productos nuevos (no actualiza los existentes)

✅ **Actualizar solo los elementos actuales que tengan la misma clave principal (Only update current items that have the same primary key)**

* Solo actualiza los productos existentes
* NO crea productos nuevos

✅ **Crear elementos nuevos si no existen y actualizar los actuales que tengan la misma clave principal (Create new items if not exist and update current items that have the same primary key)** *(opción habitual)*

* Crea los productos que faltan
* Actualiza los productos existentes que coincidan (por Handle/SKU/etc.)

***

#### **Paso 3.2. Especificación de la carga (Upload specification): cuánto importar**

* **Importar todo (Import All)**: importa todo el contenido del archivo
* **Especificar importación (Specify import)**: importa solo un rango seleccionado de filas (útil para hacer pruebas)

***

#### **Paso 3.3. Filtrar datos (Filter data) (opcional)**

* **Importar solo datos que contengan … (Only import data containing …)** (regla de inclusión)
* **Excluir datos que contengan … (Exclude data containing …)** (regla de exclusión)

Utilícelo si desea importar solo determinadas filas (p. ej.: solo las filas que incluyan `SYNC`).

***

#### **Paso 3.4. Datos de imágenes (Image data) (si su CSV incluye imágenes)**

Elija una:

* **Agregar imágenes nuevas (Add new images)** (agrega imágenes sin eliminar las anteriores)
* **Solo al crear el producto (Upon creation product only)** (solo agrega imágenes a los productos nuevos)
* **Sobrescribir imágenes actuales (Overwrite current images)** (reemplaza las imágenes existentes)

***

#### **Paso 3.5. Notificaciones por correo electrónico (Email notifications) (opcional)**

Elija cuándo desea recibir correos electrónicos:

* Al iniciar la carga
* Al completar la carga
* Si hay un error en la carga

***

#### **Paso 3.6. Programar la carga (Schedule upload)**

* **Ejecutar ahora (Run now)** (importar de inmediato)\
  (Es posible que aparezcan otras opciones de programación según su plan o configuración.)

Por último, haga clic en **Guardar (Save)** (arriba a la derecha).

***

## 🧪 Ejemplo: actualizar productos existentes + crear nuevos

**Muestra de CSV**

| Handle              | Title               | Vendor     |
| ------------------- | ------------------- | ---------- |
| ceramic-table-lamp  | Ceramic Table Lamp  | ModernHome |
| wooden-floor-mirror | Wooden Floor Mirror | ModernHome |

**Ajustes que debe elegir**

* **Clave principal**: Handle del producto
* **Encabezado de columna**: Handle
* **Coincidencia e importaciones**: Crear elementos nuevos si no existen y actualizar los actuales que tengan la misma clave principal

**Resultado**

* Si `ceramic-table-lamp` ya existe → se actualizará
* Si `wooden-floor-mirror` no existe → se creará

***

**🙋 ¿Necesita más ayuda?**

Si todavía necesita ayuda, escríbanos a <hi@tipo.io>. Estaremos encantados de ayudarle.
