# Importar com ficheiros CSV

Utilize a importação CSV para criar ou atualizar rapidamente produtos (e inventário) na sua loja Shopify através de um ficheiro de folha de cálculo.

## ✅ Antes de começar (requisitos)

#### 📌 Prepare o seu ficheiro CSV

Certifique-se de que o seu CSV tem:

* **Cabeçalhos de coluna** na primeira linha (ex.: `Handle`, `Title`, `Vendor`)
* Uma **chave única** que possa utilizar para fazer corresponder registos (recomendado: **Handle**)
* Formato correto (ficheiro CSV)

#### 🔑 Chave primária recomendada

* **Handle do produto (Product Handle)** (a melhor opção para a maioria das importações)
* Poderá também ver outras chaves consoante os seus dados (ex.: ID do produto, SKU da variante)

***

## 🛠️ Passos para carregar o ficheiro

### Abrir os Carregamentos CSV na aplicação Tipo

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

1. No Shopify Admin, abra **Aplicações → Tipo Sync**
2. Clique em **Carregamentos CSV (CSV uploads)**
3. Clique em **Adicionar ficheiro CSV (Add csv file)**

Será encaminhado para o assistente de importação (**progresso 1/3**).

***

### 📤 Passo 1/3 — Carregar o CSV

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

#### **Escolha a origem do carregamento**

Pode carregar o CSV a partir de:

* **Importação CSV (CSV Import)** (carregar um ficheiro do seu computador)
* Importar a partir de hiperligação Web (URL)
* Carregamento por servidor FTP
* Carregamento por servidor SFTP

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

**Separador (Separator)**

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

**Dados CSV (CSV Data)**

* **Produto (Product)** (para campos de produto como título, descrição, fornecedor…)
* **Inventário (Inventory)** (para quantidades de inventário)

Depois clique em **Passo seguinte (Next Step)**.

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

***

### 🧩 Passo 2/3 — Mapear campos

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

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

Isto indica à aplicação como fazer corresponder as linhas do seu CSV aos produtos no Shopify.

* **Chave primária (Primary Key)**: escolha o critério pelo qual a sua loja Shopify fará a correspondência\
  Exemplo: **Handle do produto**
* **Título da coluna (Column heading)**: escolha a coluna do seu CSV\
  Exemplo: **Handle**

> Se a sua chave primária não corresponder, a aplicação pode criar duplicados ou não conseguir atualizar o produto correto.

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

Verá separadores como:

* **Produto**
* **Variante (Variant)**
* **Imagem (Image)**
* **Metacampo (Metafield)**
* **Inventário**

Para cada linha:

* **Importar para o Shopify (Import to Shopify)** = campo do Shopify (ex.: Title)
* **Título da coluna** = coluna do CSV (ex.: Title)

Pode clicar em **➕ Adicionar mapeamento (Add mapping)** para importar mais campos.

Depois clique em **Passo seguinte (Next Step)**.

***

### ⚙️ Passo 3/3 — Definições de importação

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

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

Escolha uma:

✅ **Criar novos itens (Create new items)**

* Cria apenas novos produtos (sem atualizar os existentes)

✅ **Atualizar apenas os itens atuais com a mesma chave primária (Only update current items that have the same primary key)**

* Atualiza apenas produtos existentes
* NÃO cria novos

✅ **Criar novos itens se não existirem e atualizar os itens atuais com a mesma chave primária (Create new items if not exist and update current items that have the same primary key)** *(escolha comum)*

* Cria os produtos em falta
* Atualiza os produtos existentes que correspondam (por Handle/SKU/etc.)

***

#### **Passo 3.2. Especificação do carregamento (quanto importar)**

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

***

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

* **Importar apenas dados que contenham … (Only import data containing …)** (regra de inclusão)
* **Excluir dados que contenham … (Exclude data containing …)** (regra de exclusão)

Utilize esta opção se quiser importar apenas determinadas linhas (ex.: apenas as linhas que incluam `SYNC`).

***

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

Escolha uma:

* **Adicionar novas imagens (Add new images)** (adiciona imagens sem remover as antigas)
* **Apenas na criação do produto (Upon creation product only)** (adiciona imagens apenas para novos produtos)
* **Substituir imagens atuais (Overwrite current images)** (substitui as imagens existentes)

***

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

Escolha quando quer receber e-mails:

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

***

#### **Passo 3.6. Agendar carregamento**

* **Executar agora (Run now)** (importar imediatamente)\
  (Poderão aparecer outras opções de agendamento consoante o seu plano/definições.)

Por fim, clique em **Guardar (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 |

**Definições a escolher**

* **Chave primária**: Handle do produto
* **Título da coluna**: Handle
* **Correspondência e importações**: Criar novos itens se não existirem e atualizar os itens atuais com a mesma chave primária

**Resultado**

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

***

**🙋 Ainda precisa de ajuda?**

Se ainda precisar de ajuda, não hesite em contactar-nos através de <hi@tipo.io>. Teremos todo o gosto em ajudá-lo(a).
