Pular para o conteúdo

Pesquise guias para Multistore Inventory Sync.

    Baixar MarkdownSalvar uma cópia deste guia

    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.

    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)
    • 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)

    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).


    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

    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.

    Esta captura de tela não está disponível na documentação original.

    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)

    • 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)

    Escolha quando deseja receber e-mails:

    • No início do envio
    • Na conclusão do envio
    • Em caso de erro no 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-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ê.