Importar com arquivos CSV
Visão geral da IA
Explica como usar a CSV Import no app Tipo Sync para criar ou atualizar produtos e estoque na sua loja Shopify a partir de uma planilha. Um assistente de três etapas cuida do upload, do mapeamento de campos e das configurações de importação. O seu CSV precisa ter os cabeçalhos das colunas na primeira linha e uma chave única, de preferência Handle.
Ver maisVer menos
- Prepare um CSV com cabeçalhos e uma chave única, como Handle.
- Em Apps > Tipo Sync, clique em CSV uploads > Add csv file.
- Etapa 1: escolha a origem do upload, o separador e o CSV Data (Product ou Inventory).
- Etapa 2: defina a Primary Key e mapeie as colunas do CSV para os campos da Shopify; uma chave incompatível pode criar duplicatas ou impedir a atualização.
- Etapa 3: escolha a correspondência, o intervalo de importação, os filtros, o tratamento de imagens, os e-mails e o agendamento e clique em Save.
Resumo gerado por IA. Ele pode conter erros, então confira o guia completo abaixo.
Use o CSV Import para criar ou atualizar rapidamente produtos (e estoque) na sua loja Shopify usando uma planilha.
✅ Antes de começar (requisitos)
Seção intitulada “✅ Antes de começar (requisitos)”📌 Prepare seu arquivo CSV
Seção intitulada “📌 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
Seção intitulada “🔑 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
Seção intitulada “🛠️ Passos para enviar o arquivo ”Abra o CSV Uploads no app Tipo
Seção intitulada “Abra o CSV Uploads no app Tipo”
- No admin da Shopify, abra Apps → Tipo Sync
- Clique em CSV uploads
- Clique em Add csv file
Você será direcionado ao assistente de importação (progresso 1/3).
📤 Passo 1/3 — Enviar CSV
Seção intitulada “📤 Passo 1/3 — Enviar CSV ”
Escolha a origem do envio
Seção intitulada “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
Seção intitulada “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.
🧩 Passo 2/3 — Mapear campos
Seção intitulada “🧩 Passo 2/3 — Mapear campos ”
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
Seção intitulada “⚙️ Passo 3/3 — Configurações de importação ”
Passo 3.1. Correspondência e importações (como atualizar a Shopify)
Seção intitulada “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)
Seção intitulada “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)
Seção intitulada “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)
Seção intitulada “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)
Seção intitulada “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
Seção intitulada “Passo 3.6. Agendar envio ”- 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
Seção intitulada “🧪 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-lampjá existir → ele será atualizado - Se
wooden-floor-mirrornã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ê.