# Importar com arquivos CSV

Use o CSV Import para criar ou atualizar rapidamente produtos (e estoque) na sua loja Shopify usando uma planilha.

## ✅ Antes de começar (requisitos)

#### 📌 Prepare seu arquivo CSV

Certifique-se de que seu CSV tenha:

* **Cabeçalhos de coluna** na primeira linha (ex.: `Handle`, `Title`, `Vendor`)
* Uma **chave única** para correlacionar os registros (recomendado: **Handle**)
* Formato correto (arquivo CSV)

#### 🔑 Chave primária recomendada

* **Product Handle** (melhor para a maioria das importações)
* Você também pode ver outras chaves, dependendo dos seus dados (ex.: Product ID, Variant SKU)

***

## 🛠️ Passos para enviar o arquivo&#x20;

### Abra o CSV Uploads no app Tipo

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

1. No admin da Shopify, abra **Apps → Tipo Sync**
2. Clique em **CSV uploads**
3. Clique em **Add csv file**

Você será direcionado ao assistente de importação (progresso **1/3**).

***

### 📤 Passo 1/3 — Enviar CSV&#x20;

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

#### **Escolha a origem do envio**

Você pode enviar o CSV a partir de:

* **CSV Import** (envie o arquivo do seu computador)
* Import from Web Link (URL)
* FTP Server Upload
* SFTP Server Upload

#### **Escolha as opções do CSV**

**Separador**

* Vírgula (mais comum)
* Ponto e vírgula
* Outro

**Dados do CSV**

* **Product** (para campos do produto, como título, descrição, fornecedor…)
* **Inventory** (para quantidades de estoque)

Em seguida, clique em **Next Step**.

<figure><span class="missing-media" role="note">Esta captura de tela não está disponível na documentação original.</span><figcaption></figcaption></figure>

***

### 🧩 Passo 2/3 — Mapear campos&#x20;

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

**A) Mapeamento da chave primária**

Isso informa ao app como correlacionar as linhas do seu CSV com os produtos na Shopify.

* **Primary Key**: escolha pelo que a sua loja Shopify fará a correspondência\
  Exemplo: **Product Handle**
* **Column heading**: escolha a coluna do seu CSV\
  Exemplo: **Handle**

> Se a sua Primary Key não corresponder, o app pode criar duplicatas ou falhar ao atualizar o produto correto.

**B) Mapeie as colunas do CSV para os campos da Shopify**

Você verá abas como:

* **Product**
* **Variant**
* **Image**
* **Metafield**
* **Inventory**

Para cada linha:

* **Import to Shopify** = campo da Shopify (ex.: Title)
* **Column heading** = coluna do CSV (ex.: Title)

Você pode clicar em **➕ Add mapping** para importar mais campos.

Em seguida, clique em **Next Step**.

***

### ⚙️ Passo 3/3 — Configurações de importação&#x20;

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

#### **Passo 3.1. Correspondência e importações (como atualizar a Shopify)**

Escolha uma opção:

✅ **Create new items**

* Cria apenas novos produtos (não atualiza os existentes)

✅ **Only update current items that have the same primary key**

* Atualiza apenas produtos existentes
* NÃO cria novos produtos

✅ **Create new items if not exist and update current items that have the same primary key** *(escolha comum)*

* Cria os produtos que estão faltando
* Atualiza os produtos existentes que correspondem (por Handle/SKU/etc.)

***

#### **Passo 3.2. Especificação do envio (quantos itens importar)**

* **Import All**: importa tudo o que está no arquivo
* **Specify import**: importa apenas um intervalo selecionado de linhas (útil para testes)

***

#### **Passo 3.3. Filtrar dados (opcional)**

* **Only import data containing …** (regra de inclusão)
* **Exclude data containing …** (regra de exclusão)

Use isto se quiser importar apenas determinadas linhas (ex.: somente as linhas que incluem `SYNC`).

***

#### **Passo 3.4. Dados de imagem (se o seu CSV incluir imagens)**

Escolha uma opção:

* **Add new images** (adiciona imagens sem remover as antigas)
* **Upon creation product only** (adiciona imagens apenas para produtos novos)
* **Overwrite current images** (substitui as imagens existentes)

***

#### **Passo 3.5. Notificações por e-mail (opcional)**

Escolha quando deseja receber e-mails:

* No início do envio
* Na conclusão do envio
* Em caso de erro no envio

***

#### **Passo 3.6. Agendar envio**&#x20;

* **Run now** (importa imediatamente)\
  (Outras opções de agendamento podem aparecer, dependendo do seu plano ou das configurações.)

Por fim, clique em **Save** (canto superior direito).

***

## 🧪 Exemplo: atualizar produtos existentes + criar novos

**Exemplo de CSV**

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

**Configurações a escolher**

* **Primary Key**: Product Handle
* **Column heading**: Handle
* **Matching & Imports**: Create new items if not exist and update current items that have the same primary key

**Resultado**

* Se `ceramic-table-lamp` já existir → ele será atualizado
* Se `wooden-floor-mirror` não existir → ele será criado

***

**🙋 Ainda precisa de suporte?**

Se ainda precisar de ajuda, entre em contato conosco pelo e-mail <hi@tipo.io>. Teremos prazer em ajudar você.
