Como importar cadastros por planilha

Atualizado em 25/09/2026

Quando o volume é grande, cadastrar item a item deixa de fazer sentido. A importação por planilha existe para isso: você preenche um arquivo CSV com uma linha por registro, envia esse arquivo e a plataforma cria (ou atualiza) tudo de uma vez. Melhor ainda, ela cria junto os cadastros relacionados que ainda não existem, como as categorias dos produtos e as variações dos SKUs.

O recurso aparece em seis telas, sempre pelo botão Importar na listagem:

Estoques > Produtos, com as opções Adicionar por planilha e Editar por planilha.
Estoques > SKUs, com as mesmas duas opções.
Cadastros > Variações, também com Adicionar por planilha e Editar por planilha.
Brindes & Cupons > Cupom Padrão, apenas com Adicionar por planilha.
Clientes > Clientes, apenas com Adicionar por planilha.
Marketing & SEO > Redirecionamentos 301, apenas com Adicionar por planilha.

Cada tela tem a sua planilha, e elas não se misturam

Esta é a causa mais comum de uma importação recusada, então vale começar por ela. Cada uma dessas importações tem um modelo próprio, com colunas próprias, e a conferência é rigorosa: a plataforma compara a primeira linha do seu arquivo com o modelo esperado, coluna por coluna, na ordem. Se algum nome não bater, a importação para antes de gravar qualquer coisa e mostra, posição por posição, o nome que era esperado e o que veio no seu arquivo.

Nos SKUs e nas variações, em que as duas planilhas têm colunas diferentes, a plataforma vai além: ela reconhece quando o arquivo enviado é o modelo da outra tela e diz isso na mensagem, apontando onde essa planilha deve ser enviada. Nos produtos esse reconhecimento não é possível, porque as duas planilhas têm exatamente as mesmas colunas, e é a seção seguinte que explica como a troca aparece nesse caso.

A conferência é rigorosa por um bom motivo. A planilha não traz um rótulo dizendo de qual tela ela veio, e a posição da coluna é o que diz à plataforma o significado de cada valor. Sem essa checagem, uma planilha de produtos enviada na tela de SKUs gravaria o nome do produto onde deveria estar o código do SKU.

Atenção: baixe a planilha modelo na mesma tela em que vai importar. O modelo de Produtos não serve para a tela de SKUs, e o modelo de Adicionar não serve para a importação de Editar. Também não reaproveite uma planilha de exportação, que tem outro conjunto de colunas.

Duas exceções facilitam a vida de quem já tem arquivos prontos. Colunas extras à direita são ignoradas, e dois nomes de coluna que mudaram com o tempo continuam aceitos: quem tem planilhas antigas com "Referência" no lugar de "Vínculo ERP" ou "Profundidade" no lugar de "Comprimento" pode importar sem refazer nada.

Adicionar e Editar fazem coisas diferentes

As duas importações não são a mesma coisa em modos diferentes, são operações distintas:

Adicionar cria registros novos. Ela precisa saber a que produto o SKU pertence, quais variações ele tem, em qual categoria o produto entra.
Editar atualiza registros que já existem. Ela precisa apenas do código do registro e dos campos que você quer mudar.

Nos SKUs isso fica evidente no próprio modelo. A planilha de adicionar pede o Código Produto (o produto dono do SKU) e as quatro colunas de variação; a de editar pede o Código SKU e não tem coluna de variação nenhuma, porque a combinação de variações de um SKU que já existe não se altera por planilha.

Nos produtos as duas planilhas têm hoje as mesmas colunas, mas o comportamento continua diferente, e é por isso que a troca de uma pela outra atravessa a conferência do cabeçalho sem aviso. Na de adicionar, um Código Produto que já existe faz a linha ser recusada, e a mensagem sugere a tela de Editar por planilha. Na de editar, é o contrário: o código precisa existir, senão a linha volta avisando que o produto não existe e sugerindo a tela de Adicionar por planilha. Nos dois casos o aviso chega por linha, depois do envio, na tela de transmissões que a última seção deste artigo explica.

Vale conhecer uma gentileza da importação de editar: campo em branco não apaga o valor atual. Para reajustar só o preço de venda de duzentos SKUs, preencha o código e a coluna de preço, e deixe o resto do arquivo vazio.

Os cinco passos da tela

O formulário é o mesmo em todas essas telas, dividido em passos:

Baixar planilha modelo. O arquivo vem com o cabeçalho pronto, na ordem certa. Ele é o único jeito seguro de acertar as colunas.
Conferir dados. O passo lista as colunas esperadas, para você comparar com o que preencheu.
Enviar planilha para importação. Você seleciona o arquivo CSV salvo no seu computador.
Definir separador de colunas. Vírgula ou ponto e vírgula, conforme o programa que gerou o arquivo (Excel, Google Sheets e Numbers têm padrões diferentes).
Revisar dados antes da importação. O conteúdo do arquivo aparece na tela, exatamente como a plataforma vai lê-lo. É a última chance de perceber que veio a planilha errada. Conferido, clique em Gravar.

O que vai em cada coluna

O modelo é sempre a fonte da verdade das colunas, e o Passo 2 da tela mostra a lista completa. Alguns campos merecem explicação:

Código Produto e Código SKU — são os códigos internos e numéricos da plataforma, os mesmos que aparecem nas listagens. Não confunda com o Vínculo ERP.
Vínculo ERP — o Código de Vínculo com o ERP, que liga o cadastro daqui ao do seu sistema de gestão. É opcional, e não pode se repetir em dois produtos nem em dois SKUs.
Largura, Altura e Comprimento — as medidas de uma unidade do produto embalado, do jeito que ela sai da bancada, e nunca as da caixa de despacho. A cotação de frete soma as medidas de cada item do carrinho, então cadastrar a caixa infla o frete.
Categoria1, Subcategoria2 e Subcategoria3 — a hierarquia de categorias do produto, explicada abaixo.
Atributo1, Valor1, Atributo2 e Valor2 — as variações do SKU, explicadas abaixo.
Quantidade — o estoque do SKU.
Peso — informe no mesmo formato do cadastro, em quilos e com três casas decimais: 1.000 para 1 kg, 0.300 para 300 g. Escrever apenas "1" resulta em um grama, porque a plataforma lê os três últimos dígitos como as casas decimais.
Preços — pode escrever no padrão brasileiro, com vírgula decimal. Tanto "1234,56" quanto "R$ 1.234,56" são entendidos como o mesmo valor.

Atributo1, Valor1, Atributo2 e Valor2

Essas quatro colunas são o coração da importação de SKUs, e a lógica delas é simples quando se separa o par. O atributo é o nome da variação, aquilo que varia (Cor, Tamanho, Sabor). O valor é a opção escolhida daquela variação (Azul, M, Morango). Um par sozinho descreve uma variação; os dois pares descrevem as duas variações que um produto aceita.

Cada linha da planilha é um SKU, ou seja, uma combinação:

Código Produto	Atributo1	Valor1	Atributo2	Valor2
1200	Cor	Azul	Tamanho	M
1200	Cor	Azul	Tamanho	G
1200	Cor	Preto	Tamanho	M

Ao processar essas três linhas, a plataforma procura a variação "Cor" no seu cadastro. Se ela não existir, cria. Depois faz o mesmo com as opções "Azul" e "Preto", e assim por diante. Ou seja, você não precisa cadastrar as variações antes: basta escrever os nomes corretamente.

E "corretamente" é a palavra importante. Como a busca é pelo nome, um erro de digitação não reaproveita a variação que já existe, ele cria outra. Uma planilha com "Azul" em uma linha e "Azull" na seguinte termina com duas cores diferentes no cadastro.

Alguns cuidados fecham o assunto:

Preencha o par completo. Atributo sem valor, ou valor sem atributo, não descreve nada.
Use a segunda variação a partir do primeiro par. Um SKU pode ter só Atributo1 e Valor1, mas não pode ter apenas o segundo par preenchido.
Produtos de tamanho único. Se o produto não tem variação, deixe as quatro colunas em branco.
Não repita a mesma combinação no mesmo produto. Cor Azul com Tamanho M existe uma vez só, e a segunda linha igual é recusada.

Atenção: o primeiro SKU do produto fixa o formato de variação dele. Se o produto começou com duas variações, todos os SKUs seguintes precisam vir com duas; se começou sem nenhuma, os próximos também vêm sem. Linhas fora do formato são recusadas com o aviso de que a variação não segue a estrutura anterior.

As categorias criadas junto com o produto

Nas planilhas de produtos, as três colunas de categoria formam um caminho, e não três categorias soltas. A Categoria1 fica na raiz, a Subcategoria2 é criada dentro dela e a Subcategoria3 dentro da Subcategoria2. Assim como nas variações, o que não existe é criado na hora, já ativo, e o que existe é reaproveitado pelo nome.

Há uma diferença entre as duas importações que costuma passar despercebida. Na de adicionar, a Categoria1 vira a categoria principal do produto. Na de editar, as categorias informadas são acrescentadas ao produto, e a categoria principal continua sendo a que já estava lá.

Produtos e SKUs entram desativados, clientes não

Atenção: todo produto e todo SKU criado por planilha nasce inativo, de propósito. A importação costuma trazer muitos registros de uma vez, e a chance de algo vir errado do arquivo é real, então a loja só passa a exibir depois que você confere e ativa. A ativação em massa é rápida pela edição em lote da própria listagem.

Clientes, cupons e redirecionamentos entram ativos, e o motivo é a diferença de consequência. Produto errado na vitrine é preço errado à venda, então vale segurar. Cliente inativo é uma pessoa que não consegue entrar na conta dela, e a importação existe justamente para ela poder entrar. O cupom só entra em uma compra quando alguém digita o código, e a validade que você informa na planilha já diz a partir de quando ele vale. Redirecionamentos, por sua vez, não têm o que revisar na vitrine.

Estoque: entrada na criação, balanço na edição

A coluna Quantidade tem comportamentos diferentes nas duas importações, e a diferença é justamente o que você quer em cada situação:

Na importação de adicionar, a quantidade entra como uma entrada de estoque, o saldo inicial do SKU recém-criado.
Na de editar, ela entra como um balanço: o estoque passa a ser exatamente o número informado, sem somar ao que havia. É o comportamento certo para quem importa o saldo conferido no ERP ou no inventário.

Nos dois casos a movimentação fica registrada em Estoques > Movimentações com a origem "Planilha", então dá para auditar depois o que a importação fez.

Dentro do editar, a coluna ainda separa duas intenções que se parecem. A célula em branco mantém o saldo como está, e é o que permite enviar uma planilha só de preços sem encostar no estoque. O 0 digitado zera o saldo daquele SKU, que é o caminho para dar baixa em massa no que acabou. No adicionar essa distinção não existe, porque o SKU está nascendo sem saldo.

O limite de 500 linhas

Limite: cada arquivo aceita no máximo 500 linhas, sem contar o cabeçalho. Um arquivo maior é recusado por inteiro, e nada é gravado. Para volumes maiores, divida em arquivos de até 500 linhas e importe um de cada vez.

A recusa total é intencional. Importar as primeiras 500 linhas e descartar em silêncio o resto seria pior: você olharia a listagem, veria produtos novos e não teria como saber onde o arquivo parou.

O que acontece depois de gravar

A importação não é instantânea. Ao gravar, cada linha entra em uma fila e é processada em segundo plano, uma de cada vez. A plataforma confirma que a fila foi criada e informa quantas linhas foram agendadas, e você pode sair da tela: o processamento segue sozinho.

Como cada linha é independente, uma linha com problema não derruba as demais. Ela é registrada em ERPs > Transmissões, com o motivo da recusa (o produto que não existe, a categoria que não foi encontrada, entre outros), e o restante do arquivo segue normalmente. Linhas em branco são ignoradas, e uma linha com menos colunas que o modelo (o que costuma acontecer quando alguém apaga uma coluna do arquivo) é ignorada sem aviso.

Por isso, o passo final de qualquer importação é conferir a listagem e ver se o total bate com o que você esperava.

Se a sua loja tem um ERP conectado

A importação atualiza o cadastro aqui na plataforma, e o envio desses registros para o seu ERP é um segundo passo, combinado com o nosso suporte. A razão é proteger a sua operação: a fila de envio trabalha um registro por vez, e uma planilha inteira entrando nela de uma só vez passaria à frente dos envios do dia, inclusive os dos seus pedidos.

Quando terminar a importação, é só falar com o suporte e pedir o agendamento dos registros que você alterou, informando os códigos. A planilha que você acabou de enviar já é essa lista: a primeira coluna dela é o Código SKU (ou o Código Produto), e encaminhar o próprio arquivo costuma ser o caminho mais rápido.

Esse combinado ganha importância quando a planilha zera estoque. Entre a importação e o agendamento, a loja fica com o saldo novo e o ERP ainda com o anterior, então vale deixar o agendamento alinhado logo em seguida.

Variações, atributos e valores

A importação de variações fica em Cadastros > Variações e existe nos dois modos. É o caminho de quem quer montar de uma vez a grade de cores e tamanhos antes de importar os SKUs, ou traduzir e colorir em massa as opções que já existem. As duas planilhas têm cinco colunas, e só a primeira muda:

Atributo (só no adicionar) — o atributo ao qual a linha pertence, como Cor ou Tamanho.
Código Variação (só no editar) — o código da variação que a linha altera. Ele aparece na coluna Cód. Variação da listagem e na coluna Cód. da exportação.
Nome — o nome da própria variação, como Azul ou M.
Nome US e Nome ES — o nome exibido quando a loja está em inglês ou em espanhol.
Cor de Fundo — a cor que representa a opção na loja, no formato #RRGGBB, como #1A2B3C. Uma cor escrita de outro jeito recusa a linha, e a mensagem mostra o formato esperado.

A coluna Atributo decide o que a linha cria

Na planilha de adicionar, a coluna Atributo em branco faz a linha criar um atributo, e o Nome é o nome dele. Preenchida, a linha cria um valor dentro do atributo informado. Quando esse atributo ainda não existe, ele é criado na hora, só com o nome, e o valor entra dentro dele.

Atributo	Nome	Nome US	Nome ES	Cor de Fundo
	Cor	Color	Color
Cor	Azul	Blue	Azul	#1F4E9C
Cor	Preto	Black	Negro	#000000

As linhas são gravadas na ordem do arquivo. Coloque cada atributo acima dos valores, para as traduções e a cor dele entrarem junto na mesma importação.

Um nome não se repete dentro do mesmo atributo

A linha cujo nome já existe no mesmo atributo é recusada. Para encontrar a variação que já usa esse nome, filtre a listagem pelo Nome. Se a intenção era mudar essa variação, como traduzir ou trocar a cor, o caminho é a planilha de editar. Maiúsculas, minúsculas e acentos não diferenciam nomes, então "azul" e "Azul" são o mesmo valor. Já em atributos diferentes o mesmo nome convive sem problema, como Azul em Cor e Azul em Cor da Alça.

Na planilha de editar vale a regra das outras importações de editar, e a célula em branco mantém o valor atual. O código precisa existir, e um código que não existe volta avisando e sugerindo a tela de Adicionar por planilha.

Variações entram ativas

As variações criadas por planilha nascem ativas. Diferente do produto, uma variação sozinha não aparece na vitrine. Ela só é exibida por meio de um SKU que a usa, e o SKU importado nasce inativo.

Algumas configurações ficam fora das duas planilhas e continuam no formulário e na listagem. São o status, a pasta da variação, a opção "Mostrar no filtro de Categorias e Busca", a exibição no Google Shopping e a imagem. A pasta, em especial, não se troca por planilha, porque os SKUs que usam aquele valor continuariam apontando para ele dentro de outro atributo. O cadastro está explicado em Como funciona o cadastro de Variações.

Cupons

A importação de cupons fica em Brindes & Cupons > Cupom Padrão e existe só no modo adicionar. É o caminho de quem precisa criar muitos códigos ao mesmo tempo, como uma campanha com um cupom por influenciador. Toda linha nasce como Cupom Padrão, porque a planilha não traz a coluna Tipo de cupom. São quatorze colunas:

Código — é limpo antes de gravar, sem espaços, sem acentos e todo em minúsculas. Um código que já existe é recusado.
Tipo de Margem — R$ para desconto em reais, % para percentual.
Margem de Desconto, Valor Mínimo de Compra e Qtde. Mínima de Itens — a primeira faixa de desconto. Os valores seguem o padrão brasileiro, como no resto das importações.
Reutilizável e as quatro colunas Combina — recebem 1 para ligar e 0 para desligar. As colunas Combina são as regras de acúmulo com outros descontos, explicadas em Como funciona a gestão de Cupons de Desconto.
Validade de e Validade até — aceitam 30/05/2026 ou 2026-05-30. Em branco, o cupom nasce sem prazo na prática. Uma data que não existe no calendário, como 31/02/2026, recusa a linha.

A planilha preenche apenas a primeira faixa. As outras três faixas, as mensagens do checkout e o afiliado ficam para a edição do cupom.

Clientes, a importação que já cria o acesso

A importação de clientes fica em Clientes > Clientes e existe só no modo adicionar. É o caminho de quem migra a carteira de outra plataforma, ou traz para a loja a base de uma operação que já existia fora dela. São seis colunas:

Nome Completo — nome e sobrenome. Um nome de uma palavra só é recusado.
E-mail — é com ele que o cliente entra na conta, então precisa ser válido e não pode se repetir em dois cadastros.
CPF — pode vir com ou sem pontuação, e é conferido de verdade (o dígito verificador precisa fechar). Também não se repete entre clientes.
Nascimento — a data completa em uma coluna só, explicada abaixo.
Celular DDI — o código do país, 55 no Brasil. Em branco, a plataforma assume 55.
Celular com DDD — o número com o DDD na frente. Pode vir com máscara.

A senha inicial é o CPF

Atenção: cada cliente importado nasce com o próprio CPF, sem pontos e sem traço, como senha. É o que permite que ele entre na conta desde o primeiro dia, acompanhe pedidos e reaproveite endereços. Avise a sua base para trocar a senha no primeiro acesso.

Como escrever a data de nascimento

A data é o campo que mais sofre em planilha, porque cada programa a escreve do seu jeito e a base de origem de uma migração costuma escrever de um terceiro. Em vez de exigir um formato único, a coluna Nascimento aceita os quatro que aparecem na prática:

Como você escrever	Como é lido
30/05/1990	30 de maio de 1990
30-05-1990	30 de maio de 1990
1990-05-30	30 de maio de 1990
1990/05/30	30 de maio de 1990

O dia e o mês podem vir com um dígito só (5/3/1990). O ano precisa dos quatro dígitos: escrito como 90, ele não diz o século, e a plataforma prefere avisar a chutar cem anos de diferença.

Quando a data informada não existe no calendário (31 de fevereiro, mês 13, um ano anterior a 1900), o cliente é cadastrado com 01/01/1901. Quando a coluna fica vazia, com 01/01/1900, que é a marca de "não informado" usada na plataforma.

Se a sua planilha veio de uma base em inglês e traz a data como mês/dia/ano, ela é lida corretamente sempre que o primeiro número passar de 12 (12/25/1990 só pode ser 25 de dezembro). Quando os dois números cabem em 12, como em 05/03/1990, a leitura é a brasileira: dia 5 de março. Nesse caso, converta a coluna para um dos formatos da tabela antes de importar.

A diferença entre as duas datas é proposital e serve a você: filtrando o ano 1901 na listagem de Clientes, aparecem exatamente os cadastros que vieram com erro de digitação na planilha, prontos para corrigir.

Ninguém recebe e-mail por causa da importação

Os clientes importados entram sem o e-mail de boas-vindas e fora da lista de newsletter, de propósito. A base que você está trazendo já é sua, e disparar centenas de mensagens de boas-vindas para quem já compra com você faria mais mal que bem. Se quiser incluí-los depois nas notificações e na newsletter, a edição em lote da listagem resolve.

O e-mail de boas-vindas já nasce marcado como entregue para cada cliente importado, então ligar as notificações na edição em lote não dispara a mensagem depois. A partir dali eles recebem as comunicações normais da loja, como qualquer outro cliente, e nunca a de conta recém-criada.

Um cadastro pode ser recusado por nome sem sobrenome, e-mail inválido, CPF que não passa na conferência, e-mail ou CPF já usados por outro cliente, e telefone fora do formato brasileiro. Como sempre, o motivo de cada linha recusada fica registrado, e o restante do arquivo segue normalmente.

Redirecionamentos, o caso mais simples

A importação de redirecionamentos existe só no modo adicionar e tem apenas duas colunas: URL De (o endereço antigo) e URL Para (o destino). É o caminho natural de uma migração de plataforma, quando existem centenas de links antigos para preservar.

Informe só o caminho do endereço, começando com "/", sem o domínio da loja. Cada endereço de origem entra uma vez só, então uma URL De repetida é recusada. O funcionamento dos redirecionamentos está explicado em Como funciona o gerenciamento de Redirecionamentos 301.

Para entender melhor o que cada campo significa antes de preencher a planilha, vale reler o cadastro de Produtos, o cadastro de SKUs e o cadastro de Clientes.