A planilha de produtos da Yampi é a forma mais prática de cadastrar os itens da sua loja em massa. Produtos e variações (SKUs) ficam em uma única planilha: cada linha representa uma variação, e linhas com o mesmo identificador pertencem ao mesmo produto.

Marcas, categorias, variações, coleções, filtros e selos que ainda não existem no seu painel são criados automaticamente durante a importação. Você preenche a planilha, envia e a Yampi cuida do resto.

Neste artigo, vamos mostrar:

Quais as regras e especificações da planilha de produto?
Como cadastrar variações (SKUs) na planilha?
Como preencher a planilha de produtos?
Exemplo de preenchimento
Como importar a planilha de produtos?
Como corrigir erros na importação da planilha?
Dúvidas frequentes

🚨Importante: utilize sempre a planilha modelo da Yampi, disponível no próprio painel em Produtos → Importar planilha → Baixar modelo.

Não subimos planilhas de outras plataformas, somente a planilha própria da Yampi, que possui o formato que a plataforma processa.

💡 Para alterar produtos que já estão cadastrados, veja o artigo Como atualizar produtos em massa via planilha?

Quais as regras e especificações da planilha de produto?

A estrutura da planilha não deve ser alterada, assim como sua formatação. É necessário utilizar a nossa planilha, disponibilizada no tutorial. A Yampi processa apenas este formato, portanto não inclua, exclua ou altere a ordem das colunas, nem adicione qualquer tipo de formatação a elas.

Regras de importação da planilha📋

1. Cada linha da planilha representa uma variação (SKU). Produto simples ocupa uma linha; produto com variações ocupa uma linha por variação;.

2. Linhas com o mesmo slug pertencem ao mesmo produto e devem ficar juntas na planilha (sem linhas de outros produtos entre elas). Nessas linhas, as informações do produto se repetem;

3. Marcas, categorias, coleções, filtros, selos e variações que ainda não existem no painel são criados automaticamente durante a importação;

4. Estoques são a exceção: eles são vinculados pelo nome, mas não são criados pela planilha. Estoques informados com nome inexistente são ignorados, sem impedir a criação do produto e da variação;

5. Utilize a planilha modelo da Yampi e não renomeie nem exclua as colunas: a leitura é feita pelo nome de cada coluna, e coluna esperada ausente ou nome duplicado no cabeçalho geram erro na importação.

Especificações da planilha 📏

Formatos aceitos: .xls, .xlsx e .csv;
Máximo de 15.000 linhas por planilha (sem contar o cabeçalho);
Tamanho máximo do arquivo: 15 MB;
Máximo de 2.000 variações (linhas) por produto;
Colunas de preenchimento obrigatório: slug, sku, nome e preco_venda. A coluna variacoes é obrigatória para produtos com mais de uma variação.

Atenção ao preenchimento da planilha ⚠️

Para garantir que a importação ocorra corretamente, siga estas regras:

Estrutura da planilha	Preenchimento dos dados	Formatação
1. Utilize a planilha modelo da Yampi. Não utilize planilhas externas.	1. Preços devem usar ponto como separador decimal e ficar sem símbolos (exemplo: `100.00` em vez de `R$100,00`).	1. Não use cores, negrito ou qualquer tipo de formatação visual.
2. Não renomeie as colunas do modelo.	2. Se houver mais de um valor na mesma célula, separe os itens por ponto e vírgula (;), sem espaços.	2. Certifique-se de que não há espaços extras antes ou depois dos nomes das colunas.
3. A planilha deve conter apenas uma aba (sem múltiplas páginas).	3. Todas as colunas obrigatórias devem estar preenchidas.	3. Não utilize colunas ocultas.
4. Mantenha as linhas de um mesmo produto em sequência, uma logo abaixo da outra.	4. Campos sim/não devem ser preenchidos com `sim` ou `nao` (sem acento).	4. Não importe planilha de outras plataformas.

Como cadastrar variações (SKUs) na planilha?

Na planilha da Yampi, cada linha representa uma variação (SKU). Funciona assim:

Tipo de produto	Como preencher
Produto simples (sem variações)	Preencha uma única linha com as informações do produto e deixe a coluna `variacoes` em branco.
Produto com variações	Preencha uma linha para cada variação, usando o mesmo `slug` em todas as linhas do produto. As informações do produto (nome, marca, categorias) se repetem, e os dados próprios de cada variação mudam de linha para linha.

As colunas que definem cada variação são:

variacoes: preencha com o nome da variação e o valor correspondente, separados por dois pontos. Para mais de uma variação, separe com ponto e vírgula. Exemplo: Cor:Azul;Tamanho:M;
sku: código único da variação dentro do produto;
preco_venda, estoques, peso e dimensões: cada variação tem preço, estoque e medidas próprios;
llink_fotos_sku: URLs públicas das imagens da variação, separadas por ponto e vírgula;
imagens_diferentes_por_sku: define se cada variação tem imagens próprias ou se todas usam as mesmas.

Cada produto aceita até 2.000 variações, e as linhas de um mesmo produto devem aparecer em sequência na planilha, uma logo abaixo da outra, sem linhas de outros produtos entre elas.

⚠️Atenção: Variações e valores que ainda não existem no seu painel são criados automaticamente durante a importação. Todas as linhas de um mesmo produto devem usar as mesmas variações: se uma linha tem Cor e Tamanho, todas precisam ter Cor e Tamanho.

Como preencher uma planilha de produtos?

Veja abaixo o mapeamento das células da planilha e como devem ser preenchidas. Os campos de preenchimento obrigatório estarão marcados com um *.

▶️ Clique na setinha de cada um para abrir o conteúdo*

Identificação

slug*

Identificador único do produto e endereço da página na loja. Linhas com o mesmo slug pertencem ao mesmo produto. Use apenas letras minúsculas, números e hífen (exemplo: camisa-polo). O slug de um produto não pode ser alterado pela planilha.

(Obs: Ao criar uma slug, lembrar-se de utilizar apenas letras minúsculas e substituir os espaços por hifens. Exemplo: produto-x-cor-azul.)

sku*

Código da variação (SKU). Identifica a variação dentro do produto, então precisa ser único apenas entre as linhas do mesmo slug. Produtos diferentes podem usar o mesmo código.

Informações do produto

Estas colunas se repetem em todas as linhas de um mesmo produto.

nome*

Nome do produto. Exemplo: Camisa Polo.

descricao

Descrição completa do produto. Aceita HTML.

ativo

sim ou nao. Se ficar em branco, o produto é criado como ativo.

buscavel

sim para o produto aparecer na busca da loja, nao para ser acessado apenas pela URL. Se ficar em branco, é considerado sim.

produto_digital

sim para produtos sem cálculo de frete, nao para frete calculado normalmente. Se ficar em branco, é considerado nao.

marca

Nome da marca. Se a marca não existir no painel, ela é criada automaticamente. Se ficar em branco, o produto entra como "Sem marca".

categorias

Nomes separados por ponto e vírgula. Para subcategoria, use >. Exemplo: Roupas>Camisas;Esportes. Categorias novas são criadas automaticamente.

colecoes

Nomes separados por ponto e vírgula. Coleções novas são criadas automaticamente.

filtros

Pares Nome:Valor separados por ponto e vírgula. Exemplo: Material:Algodão;Estilo:Casual. Filtros e opções novos são criados automaticamente.

selos

Nomes separados por ponto e vírgula. Selos novos são criados automaticamente.

categoria_google

Categoria correspondente no Google Shopping.

codigo_erp_produto

Código do produto no seu ERP (caso possua).

ncm

Código NCM do produto, utilizado em notas fiscais.

meses_de_garantia

Número inteiro com os meses de garantia. Sem garantia, preencha com 0.

frete_customizado

sim caso o produto tenha frete próprio, nao caso siga as regras de frete da loja. Se ficar em branco, é considerado nao.

valor_do_frete

Valor do frete customizado. Obrigatório quando frete_customizado for sim.

especificacoes

Especificações técnicas do produto, em texto livre.Nesse campo você pode informar as especificações técnicas do produto. Exemplo: Cor azul; tamanho X; peso Y.

medidas

Informações de medidas do produto, em texto livre.

video

Link de vídeo do produto (exemplo: URL do YouTube).

link_fotos_sku

URLs públicas das imagens da variação. A imagem é baixada automaticamente durante a importação. Aceita mais de uma foto, separadas por ponto e vírgula, e a ordem das fotos na loja segue a ordem da planilha.

seo_titulo_pagina

Título que aparece na aba do navegador e nos resultados de busca.

seo_descricao

Breve descrição da página, com até 160 caracteres.

seo_palavras_chave

Palavras-chave separadas por ponto e vírgula.

link_canonico

URL canônica da página do produto.

termos_de_busca

Termos que a busca da sua própria loja utiliza para encontrar o produto. Insira maneiras diferentes que os clientes usam para buscá-lo, sem repetir o que já está no nome.

Separe os termos de busca deste produto por ponto e vírgula, exemplo: (temos; produto; busca). Esses são os termos que o mecanismo de busca de sua própria loja utilizará para encontrar os produtos.

📌Importante: Não é necessário inserir termos que já estejam no nome do produto, o interessante aqui é inserir outras maneiras comuns que os clientes possam utilizar para encontrá-lo.

Variações

variacoes

Preencha com o nome da variação e o valor correspondente, separados por dois pontos. Para mais de uma variação, separe com ponto e vírgula.

Exemplo: Cor:Azul;Tamanho:M. Variações e valores novos são criados automaticamente. Obrigatória quando o produto tem mais de uma variação, e todas as linhas do produto devem usar as mesmas variações (se uma linha tem Cor e Tamanho, todas devem ter Cor e Tamanho). Para produto simples, deixe em branco.

Informações da variação (SKU)

Estas colunas podem variar de linha para linha.

preco_venda*

Preço de venda exibido ao cliente. Decimal com ponto. Exemplo: 49.90.

preco_custo

Preço de custo, para controle interno. Não é exibido na loja.

preco_promocional

Preço com desconto, exibido no formato "de/por". Deve ser menor que o preco_venda.

codigo_de_barras

Código de barras (EAN/UPC), usado em marketplaces e emissão de NF-e.

codigo_erp_sku

Código da variação no seu ERP (caso possua).

estoques

Quantidade em estoque da variação. Aceita dois formatos:

Número puro (exemplo: 100): a quantidade vai para o estoque padrão da loja;
Pares Estoque:Quantidade (exemplo: Principal:100;SP:50): distribui as quantidades entre estoques já cadastrados, identificados pelo nome.

O valor informado é o estoque final (substitui o atual). Se a coluna ficar vazia, o estoque não é alterado. Estoques precisam existir no painel: nomes não encontrados são ignorados, sem impedir a criação do produto e da variação.

estoque_gerenciado

sim ou nao. Se nao, a quantidade informada é ignorada. Se ficar em branco, é considerado sim

disponivel_para_venda

sim ou nao. Se ficar em branco, é considerado sim.

dias_de_disponibilidade

Número inteiro com os dias úteis de disponibilidade. 0 para disponibilidade imediata.

dias_de_disponibilidade_se_zerar_o_estoque

Número inteiro. -1 torna o produto indisponível quando o estoque zera; 0 continua vendendo normalmente; demais valores mudam a disponibilidade para a quantidade de dias úteis informada.

peso_em_kg

Peso em kg, com ponto como separador decimal. Exemplo: um produto de 750g deve ser preenchido como 0.750.

altura_em_cm

Altura em cm. Exemplos: 100; 10.5.

largura_em_cm

Largura em cm. Exemplos: 100; 10.5.

comprimento_em_cm

Comprimento em cm. Exemplos: 100; 10.5.

imagens_diferentes_por_sku

Define se as variações usam as mesmas imagens. Caso afirmativo, todas as linhas da coluna link_fotos_sku devem ser iguais para os skus do mesmo produto

📦 Importante: as colunas de peso e dimensões são essenciais para o cálculo do frete e a exibição das cotações no checkout. Preencha sempre que possível.

A exceção são lojas que trabalham com dropshipping, nacional ou internacional.

Agora com a sua planilha de produtos preenchida, acesse no menu “Produtos” → “Importar produtos” e selecionar o arquivo que será importado (lembrando que os formatos aceitos, são: xls, xlsx e csv).

Exemplo de preenchimento

Veja como ficam um produto com variações e um produto simples (mostrando apenas as colunas principais):

slug	sku	nome	marca	categorias	variacoes	preco_venda	estoques
camisa-polo	POLO-AZ-M	Camisa Polo	Adidas	Roupas>Camisas;Esportes	Cor:Azul;Tamanho:M	89.90	Principal:100;SP:50
camisa-polo	POLO-AZ-G	Camisa Polo	Adidas	Roupas>Camisas;Esportes	Cor:Azul;Tamanho:G	89.90	Principal:80
camisa-polo	POLO-PT-M	Camisa Polo	Adidas	Roupas>Camisas;Esportes	Cor:Preto;Tamanho:M	89.90	Principal:40;SP:10
caneca-yampi	CANECA-001	Caneca Yampi	Yampi	Acessórios		29.90	200

Neste exemplo, as três primeiras linhas têm o mesmo slug (camisa-polo) e formam um único produto com três variações. A última linha é um produto simples, com uma única linha e a coluna variacoes em branco.

⚠️ Importante: em produtos com mais de uma variação, a coluna variacoes deve ser preenchida em todas as linhas do produto, sempre com os mesmos eixos (por exemplo, Cor e Tamanho em todas). Se a coluna ficar vazia em um produto com várias linhas, a análise do arquivo indica o erro para correção antes da importação.

Como importar a planilha de produtos?

Passo 1 — Acesse o painel da Yampi e clique em Produtos.

Passo 2 — Clique em Importar planilha.

Passo 3 — Na janela que abrir, clique em Baixar modelo para baixar a planilha modelo da Yampi. Você também pode baixar a planilha modelo nos anexos do artigo abaixo.

Passo 4 — Preencha a planilha com seus produtos e variações (uma variação por linha), conforme indicamos acima.

⚠️Atenção: A planilha modelo vem com produtos de exemplo para orientar o preenchimento: apague essas linhas antes de importar, para que elas não sejam cadastradas na sua loja.

Passo 5 — Envie a planilha no campo indicado: clique para selecionar o arquivo ou arraste e solte. Depois, clique em Continuar.

Passo 6 — Aguarde a análise do arquivo. Nessa etapa, a Yampi verifica as linhas da planilha e identifica os produtos, as variações e as colunas mapeadas.

Passo 7 — Revise o resumo da importação. Aqui você confere:

Quantos produtos e variações foram identificados;
Quais marcas, categorias, variações e coleções vão ser criadas automaticamente;
Se algum erro foi encontrado no arquivo, com a indicação da linha e do que precisa ser corrigido.

Passo 8 — Está tudo certo? Clique em Iniciar importação.

Pronto! Seus produtos são importados e logo aparecem no catálogo. A importação continua mesmo se você fechar a página: ao recarregar, a tela de progresso reaparece para você acompanhar o andamento. O painel processa uma operação de produtos por vez, então aguarde a conclusão para enviar uma nova planilha.

💡 Dica: após clicar em Iniciar importação, você tem 10 segundos para cancelar antes do início do processamento. Também é possível cancelar durante o processo: nesse caso, apenas os itens ainda não processados deixam de ser importados.

Como corrigir erros na importação da planilha?

Durante a análise do arquivo, a Yampi verifica todas as linhas da planilha antes de importar. Se algum problema for encontrado, a tela de análise mostra cada erro com a linha e o motivo, para você corrigir direto na planilha e enviar o arquivo novamente.

Alguns pontos importantes sobre esse funcionamento:

Linhas válidas não são bloqueadas: se apenas algumas linhas tiverem erro, os demais produtos são importados normalmente;
A análise exibe até 100 erros por vez: se a planilha tiver mais, corrija os exibidos e envie novamente para visualizar os demais;
Erros são diferentes de avisos: situações como estoque com nome não encontrado não impedem a importação; o produto e a variação são criados e apenas aquela informação é ignorada.

Veja os erros mais comuns e como corrigir cada um:

Erro	Como corrigir
Coluna obrigatória ausente no cabeçalho	Baixe a planilha modelo novamente e confira se as colunas `slug`, `sku`, `nome` e `preco_venda` existem, sem alterações no nome.
Campo obrigatório vazio	Preencha `slug`, `sku`, `nome` e `preco_venda` em todas as linhas.
Slug inválido	Use apenas letras minúsculas, números e hífen, sem espaços ou caracteres especiais. Exemplo: `camisa-polo`.
Preço inválido	Use ponto como separador decimal e valor maior que zero. Exemplo: `49.90`. O preço promocional deve ser menor que o preço de venda.
Linhas do mesmo produto separadas	Mantenha todas as linhas de um mesmo slug juntas, sem linhas de outros produtos entre elas.
Informações do produto diferentes entre linhas	Nas linhas de um mesmo slug, os dados do produto (nome, marca, categorias) devem ser idênticos.
SKU repetido no mesmo produto	Cada linha de um produto deve ter um código diferente na coluna `sku`.
Combinação de variação duplicada	Cada linha deve ter uma combinação única na coluna `variacoes` (exemplo: duas linhas com `Cor:Azul;Tamanho:M` geram erro).
Coluna `variacoes` vazia em produto com várias linhas	Preencha a coluna `variacoes` em todas as linhas do produto, com os mesmos eixos.
Campo sim/não inválido	Preencha com `sim` ou `nao` (sem acento).
Arquivo acima do limite	Divida a planilha em arquivos com até 15.000 linhas e 15 MB.

Dúvidas frequentes 🤔

▶️Clique na setinha de cada um pra abrir o conteúdo*

Estou migrando pra Yampi, e tenho uma planilha de produtos da minha antiga loja. Posso usar essa planilha pra importar meus produtos na Yampi?

Não. A Yampi tem um modelo específico de leitura e não aceitamos planilhas com outros formatos e de outras plataformas. O recomendado é que utilize as informações da planilha de sua antiga loja para preencher a planilha da Yampi.

Posso subir imagens por planilha?

Sim, por meio de links. Preencha a coluna link_fotos_sku com as URLs públicas das imagens, separadas por ponto e vírgula. As imagens são baixadas automaticamente durante a importação, e a ordem delas na loja segue a ordem da planilha. Também é possível gerenciar as imagens diretamente no cadastro do produto, pelo painel da Yampi.

Todas as variações do meu produto usam as mesmas fotos. Preciso repetir os links em todas as linhas?

Use a coluna imagens_diferentes_por_sku para indicar que as variações compartilham as mesmas imagens. Nesse caso, a coluna link_fotos_sku deve ter o mesmo conteúdo em todas as linhas do produto.

Preciso cadastrar categorias, marcas, coleções e variações antes de importar a planilha?

Não. Ao importar a planilha, a Yampi identifica marcas, categorias, coleções, filtros, selos e variações que ainda não existem no seu painel e cria tudo automaticamente. O resumo da importação mostra exatamente o que vai ser criado antes de você confirmar. A única exceção são os estoques, que precisam estar cadastrados no painel.

Estou com problemas para importar minha planilha, o que fazer?

Confira os erros exibidos na tela de análise do arquivo e siga as orientações da seção Como corrigir erros na importação da planilha? deste artigo. Se o problema continuar após as correções, clique no balãozinho de atendimento em seu painel ou nos encaminhe por e-mail para [email protected].

Em caso de dúvidas, clique no balãozinho de atendimento em seu painel ou nos encaminhe pelo e-mail para [email protected] 😉

Planilha de Produtos Yampi - Modelo.csv