Otimizador de importação Shopify
Valide e corrija automaticamente CSVs de produtos do Shopify. Foco em bloqueios de importação, estrutura de variantes, preços, estoque e formatação consistente.
A descrição detalhada abaixo está em inglês.
O que este modelo verifica
48 verificações são feitas em cada arquivo. Cada uma leva a um guia com exemplos e correções.
- Coluna obrigatória ausenteCorreção automática
Falta no seu CSV um cabeçalho de coluna obrigatório do Shopify.
- Title ausente
Title está vazio em pelo menos uma linha.
- URL handle ausenteCorreção automática
URL handle está vazio em pelo menos uma linha.
- URL handle inválidoCorreção automática
URL handle contém caracteres que o Shopify pode rejeitar.
- Valor de Published inválidoCorreção automática
Published on online store tem um valor que não é booleano.
- Valor de Status inválidoCorreção automática
Status não é Active, Draft nem Archived.
- Colunas de opção fora de ordem
Option2/Option3 tem valores enquanto Option1 está vazio.
- Option1 value ausente na variante
Esta linha parece ter dados de variante, mas Option1 value está vazio.
- Price inválido
Price não é um número válido.
- Compare-at price inválido
Compare-at price não é um número válido.
- Quantidade em estoque inválida
Inventory quantity não é um inteiro válido.
- Política de estoque inválidaCorreção automática
Continue selling when out of stock não é DENY/CONTINUE.
- Status ausenteCorreção automática
A coluna Status existe, mas a linha do produto não tem valor.
- Charge tax inválidoCorreção automática
Charge tax não é true nem false.
- Requires shipping inválidoCorreção automática
Requires shipping não é true nem false.
- Gift card inválidoCorreção automática
Gift card não é true nem false.
- Cost per item inválido
Cost per item não é um número válido.
- Peso inválido
Weight value (grams) não é um número inteiro de gramas.
- Unidade de peso inválidaCorreção automática
Weight unit for display não é g, kg, lb nem oz.
- Controle de estoque inválidoCorreção automática
Inventory tracker tem um valor que o Shopify não reconhece.
- Serviço de fulfillment inválidoCorreção automática
Fulfillment service não é um handle de serviço válido.
- Dimensões da embalagem incompletas
Só parte do comprimento, largura, altura e unidade da embalagem está preenchida.
- Tags demais
Um produto tem mais de 250 tags.
- Posição de imagem inválida
Image position não é um inteiro válido.
- URL handles gerados
O arquivo não tinha coluna URL handle, então os handles foram criados a partir de cada Title.
- URL handle alterado
Um URL handle tinha caracteres que o Shopify não permite e foi reescrito.
- Nome de opção sem valor
Existe um nome de opção, mas o valor correspondente está vazio.
- Nomes de opção diferentes entre variantes
Os nomes de Option1/2/3 devem ser iguais nas linhas que compartilham um handle.
- Opções de variante não únicas
Duas ou mais variantes do mesmo handle têm valores de opção idênticos.
- "Default Title" misturado com opções reais
Um handle inclui tanto linhas "Default Title" quanto linhas de variante com opções.
- Linhas duplicadas com detalhes de variante idênticos
Há linhas com o mesmo handle que parecem duplicadas sem serem variantes de verdade.
- Mesmo handle com Titles diferentes
Vários Titles são usados em linhas que compartilham o mesmo URL handle.
- Price ausente
Price está vazio em uma linha de variante.
- Compare-at price menor que Price
Compare-at price é menor que Price.
- Estoque negativo
Inventory quantity é negativo.
- URL de imagem inválida
A URL da imagem do produto não é uma URL http(s) válida.
- Linha de imagem com campos de variante
Uma linha parece ser só de imagem, mas inclui campos SKU/Price/Options/Inventory.
- Posição de imagem duplicada
Duas linhas têm a mesma Image position para o mesmo handle.
- Texto alternativo longo demais
O texto alternativo da imagem passa do limite recomendado pelo Shopify.
- SKU duplicado
O mesmo SKU aparece em várias linhas de variante.
- SKU duplicado entre produtos
O mesmo SKU aparece em URL handles diferentes (produtos diferentes).
- Título de SEO longo demais
O título de SEO passa do tamanho recomendado.
- Descrição de SEO longa demais
A descrição de SEO passa do tamanho recomendado.
- Título de SEO ausente
O título de SEO está vazio (o Shopify vai usar Title).
- Descrição de SEO ausente
A descrição de SEO está vazia (o Shopify vai usar Description).
- URL de imagem com http
Uma URL de imagem começa com http:// em vez de https://.
- Vale-presente no CSV
Uma linha está marcada como vale-presente.
- Product category parece um ID do Google
Product category contém só dígitos, como um ID de categoria de produto do Google.
Colunas esperadas
Linha de exemplo
| Title | URL handle | Description | Vendor | Product category | Type | Tags | Published on online store | Status | SKU | Barcode | Option1 name |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Sample Product | sample-product | A short description for your product. | Your Brand | Apparel & Accessories > Clothing | T-Shirt | sample, tshirt, cotton | TRUE | active | SKU-1001 | Title |
Mostrando 12 colunas para legibilidade. Baixe o CSV de amostra para o conjunto completo de cabeçalhos.
Sobre este formato
As importações de produtos do Shopify são exigentes: um único preço malformado, um valor de opção ausente ou uma linha de imagem no lugar errado pode fazer toda a importação falhar.
Esta predefinição valida seu CSV com o modelo oficial do Shopify e aplica correções automáticas seguras para que você envie com tranquilidade. Você mantém o controle total dos seus dados: cada correção fica registrada, e o CSV exportado continua pronto para importar no Shopify.
Como funciona
- 1Envie sua exportação CSV do Shopify ou o modelo oficial.
- 2Normalizamos os cabeçalhos e os formatos comuns (booleanos, valores monetários, valores de estoque) e validamos os campos obrigatórios.
- 3Corrigimos automaticamente os problemas seguros (como remover espaços, padronizar TRUE/FALSE e normalizar campos de preço) e sinalizamos os arriscados para revisão.
- 4Exporte um CSV limpo que corresponde ao esquema esperado pelo Shopify.
Exemplos de correções
- Padronizar booleanos (TRUE/FALSE) e valores de status (active/draft/archived).
- Normalizar campos monetários (Price, Compare-at price, Cost per item) e remover símbolos de moeda soltos.
- Detectar SKUs duplicados e colisões de variantes que quebram a importação.
- Validar a estrutura de opções (nome/valor de Option1/2/3) e sinalizar linhas de variante incompletas.
- Validar as linhas de imagem (Product image URL, Image position) e sinalizar URLs ausentes ou inválidas.
- Limpar e normalizar espaços, tags e o formato dos handles para manter a consistência.
Perguntas frequentes
Isso vai alterar meus dados de produto?
Funciona com exportações de outros apps?
Posso usar o modelo oficial do Shopify?
Guias CSV populares
Guias passo a passo para os problemas de importação de CSV mais comuns.
Aprenda a estruturar as URLs de imagem no CSV de produtos do Shopify: as colunas Image Src, Image Position e Image Alt Text, como adicionar várias imagens por produto e como evitar as falhas de importação de imagens mais comuns.
Tudo o que você precisa saber sobre o campo Handle do CSV de produtos do Shopify: para que serve, as regras de um handle válido, como ele agrupa variantes e como corrigir erros de handle.
Um guia completo dos erros de importação de CSV mais comuns do Shopify: colunas ausentes, booleanos inválidos, problemas de estrutura de variantes, erros de preço e conflitos de handle.
Uma explicação coluna por coluna de cada campo do modelo CSV oficial de produtos do Shopify: o que cada coluna faz, quais valores aceita e quais são obrigatórias.
Saiba como o formato CSV do Shopify representa variantes com o agrupamento por Handle, as colunas Option e as linhas principais/secundárias. Evite os erros que dividem produtos, somem com variantes e causam falhas na importação.
Entenda a diferença entre anexar linhas, mesclar arquivos com a mesma estrutura e unir arquivos com dados relacionados. Escolha a abordagem certa para o fluxo do seu catálogo.