Criar e importar uma planilha de SKUs na Yampi exige atenção a algumas regras e especificações para garantir que os produtos e suas variações sejam cadastrados corretamente.
Neste artigo, você aprenderá como estruturar sua planilha, quais informações são obrigatórias e quais detalhes precisam ser seguidos para evitar erros na importação.
🚨Importante: não subimos planilhas de outras plataformas, somente a planilha própria da Yampi, que possui o formato que a plataforma processa.
Quais as regras e especificações da planilha de SKUs?
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. Para importar todas as informações dos produtos, é necessário criar duas planilhas, uma de Produtos e outra de SKU, não realizar a importação da planilha de SKUs antes de importar a planilha de produtos. |
2. A planilha de SKU é usada para adicionar novas variações a produtos já cadastrados ou atualizar as existentes. Mas atenção: só é possível incluir variações em produtos que já estejam configurados “com variantes”. |
3. As colunas peso_em_kg, altura_em_cm, largura_em_cm e comprimento_em_cm são opcionais e podem ficar em branco, mas é fundamental preenchê-las sempre que possível. Essas informações são essenciais para o cálculo do frete e a exibição das cotações no checkout. A única exceção são lojas que trabalham com dropshipping, nacional ou internacional. |
4. As colunas valores_de_variacoes, preço_custo, preço_venda e preço_promocional também são opcionais, mas recomendadas, pois impactam diretamente na venda dos produtos. Porém, se um produto tiver variações, a coluna valores_de_variacoes se torna obrigatória. |
Especificações da planilha 📏
Máximo 10.000 linhas;
Máximo de 1MB;
Formato .xls;
Colunas de preenchimento obrigatório para criação de produtos:
id (se for um produto já existente, para novas SKUs deve permanecer em branco)
id_produto
nome_produto
disponivel_para_venda
sku
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. Não utilize planilhas externas. | 1. Os dados devem estar previamente cadastrados no painel da Yampi. A planilha não cria essas informações, apenas vincula ao produto. | 1. Não use cores, negrito ou qualquer tipo de formatação visual. |
2. Não altere os nomes das colunas e não adicione ou remova colunas existentes. | 2. Na planilha, os nomes de cada uma dessas customizações do produto devem ser escritas exatamente como foram cadastradas na Yampi. Isso inclui letras maiúsculas e minúsculas, espaços e caracteres especiais. Qualquer diferença pode impedir a correta associação das informações. | 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. Todos as colunas obrigatórios devem estar preenchidas. | 3. Não utilize colunas ocultas. |
4. O limite é de 10.000 linhas. | 4.Se houver mais de um valor na mesma célula, os itens devem ser separados por ponto e vírgula (;), sem espaços. | 4. Não importe planilha de outras plataformas. |
Como construir e preencher uma planilha de SKUs?
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 "*".
🚨 Lembre-se: Não realize a importação da planilha de SKUs antes de importar a planilha de produtos.
▶️ Clique na setinha de cada um para abrir o conteúdo.
A1 - id*
A1 - id*
Deve ser preenchido com o código do SKU. É possível encontrar esse código no endereço da página do respectivo SKU, localizado na barra de endereços do navegador.
B1 - id_produto*
B1 - id_produto*
Deve ser preenchido com o código do produto a qual esta opção pertence/pertencerá. O código do produto pode ser encontrado na planilha de produtos ou diretamente na plataforma, através do menu "Produtos", "Ver todos", coluna "ID #".
Há também a possibilidade de se encontrar o código do produto na própria página do produto dentro da plataforma, bastando olhar-se para o endereço da página que fica na barra de endereços do navegador.
C1 - nome_produto*
C1 - nome_produto*
Deve ser preenchido com o nome do produto. Exemplo: Produto X Azul
D1 - disponivel_para_venda*
D1 - disponivel_para_venda*
Deve ser preenchido com “sim” caso o produto já esteja disponível para venda ou com "nao" caso não esteja.
E1 - sku*
E1 - sku*
Deve ser preenchido com o código SKU referente ao produto.
F1 - valores_de_variacoes
F1 - valores_de_variacoes
Deve ser preenchido com os valores das variações que esse SKU possui. Caso for um produto simples basta deixar a coluna vazia
G1 - customizacoes
G1 - customizacoes
Deve ser preenchido com o nome da customização aceita por esse SKU.
H1 - codigo_erp
H1 - codigo_erp
Deve ser preenchido com o código do produto equivalente localizado no ERP utilizado
I1 - codigo_de_barras
I1 - codigo_de_barras
Deve ser preenchido com o código de barras equivalente ao produto.
J1 - preco_custo
J1 - preco_custo
Preencher separando somente a casa decimal por ponto
K1 - preco_venda
K1 - preco_venda
Preencher separando somente a casa decimal por ponto.
L1 - preco_promocional
L1 - preco_promocional
Preencher separando somente a casa decimal por ponto.
M1 - peso_em_kg
M1 - peso_em_kg
Deve ser preenchido em kg, ou seja, se um produto pesa 750g, por exemplo, o peso deve ser convertido para kg antes de ser inserido na planilha (0,750). Preencher separando somente a casa decimal (quando necessário) por ponto. Exemplos: 0.500; 1.500; 0.196; 13.
N1 - altura_em_cm
N1 - altura_em_cm
Deve ser preenchida em cm, ou seja, se um produto mede 8 metros e meio, por exemplo, a altura deve ser convertida para cm antes de ser inserida na planilha (850). Preencher separando somente a casa decimal por ponto. Exemplos: 100; 10.5; 43; 745.
O1 - largura_em_cm
O1 - largura_em_cm
Deve ser preenchida em cm, ou seja, se um produto mede 8 metros e meio, por exemplo, a largura deve ser convertida para cm antes de ser inserida na planilha (850). Preencher separando somente a casa decimal (quando necessário) por ponto. Exemplos: 100; 10.5; 43; 745.
P1 - comprimento_em_cm
P1 - comprimento_em_cm
Deve ser preenchido em cm, ou seja, se um produto mede 8 metros e meio, por exemplo, o comprimento deve ser convertido para cm antes de ser inserido na planilha (850). Preencher separando somente a casa decimal (quando necessário) por ponto. Exemplos: 100; 10.5; 43; 745
Q1 - total_em_estoque
Q1 - total_em_estoque
Valor total da quantidade do produto em estoque
R1 - estoque_gerenciado
R1 - estoque_gerenciado
Deve ser preenchido com “sim” ou “nao”. Caso a coluna não esteja preenchida, ou esteja preenchida de forma incorreta, será utilizada a opção “nao”.
S1 - dias_de_disponibilidade
S1 - dias_de_disponibilidade
“0” para disponibilidade imediata;
“1” para disponibilidade em 1 dia útil;
“2” para disponibilidade em 2 dias úteis;
“3” para disponibilidade em 3 dias úteis;
“4” para disponibilidade em 4 dias úteis;
“5” para disponibilidade em 5 dias úteis;
“6” para disponibilidade em 6 dias úteis;
“7” para disponibilidade em 7 dias úteis;
“8” para disponibilidade em 8 dias úteis;
“9” para disponibilidade em 9 dias úteis;
“10” para disponibilidade em 10 dias úteis;
“15” para disponibilidade em 15 dias úteis;
“20” para disponibilidade em 20 dias úteis;
“25” para disponibilidade em 25 dias úteis;
“30” para disponibilidade em 30 dias úteis.
Caso a coluna seja preenchida de forma errada, será utilizada a opção “0”.
T1 - dias_de_disponibilidade_se_zerar_o_estoque
T1 - dias_de_disponibilidade_se_zerar_o_estoque
“-1” para tornar o produto indisponível;
“0” para continuar vendendo normalmente;
“1” para mudar disponibilidade para 1 dia útil;
“2” para mudar disponibilidade para 2 dias úteis;
“3” para mudar disponibilidade para 3 dias úteis;
“4” para mudar disponibilidade para 4 dias úteis;
“5” para mudar disponibilidade para 5 dias úteis;
“6” para mudar disponibilidade para 6 dias úteis;
“7” para mudar disponibilidade para 7 dias úteis;
“8” para mudar disponibilidade para 8 dias úteis;
“9” para mudar disponibilidade para 9 dias úteis;
“10” para mudar disponibilidade para 10 dias úteis;
“15” para mudar disponibilidade para 15 dias úteis;
“20” para mudar disponibilidade para 20 dias úteis;
“25” para mudar disponibilidade para 25 dias úteis;
“30” para mudar disponibilidade para 30 dias úteis.
Caso a coluna seja preenchida de forma errada, será utilizada a opção “0”.
Agora com a sua planilha de skus preenchida, acesse no menu “Produtos” → “Importar skus” e selecione o arquivo que será importado (o formato do arquivo deve ser xls).
Como validar se a minha planilha de skus está correta?
Passo 1 - Verifique se a planilha contém todas as colunas de preenchimento obrigatórios*:
- id (se for um produto já existente, para novas SKUs deve permanecer em branco)
- id_produto
- nome_produto
- disponivel_para_venda
- sku
Passo 2 - Para as colunas “valores_de_variacoes” e “customizacoes”:
- Os dados devem estar previamente cadastrados no painel da Yampi. A planilha não cria essas informações, apenas vincula ao produto.
- Na planilha, os nomes de cada uma dessas customizações do produto devem ser escritas exatamente como foram cadastradas na Yampi. Isso inclui letras maiúsculas e minúsculas, espaços e caracteres especiais. Qualquer diferença pode impedir a correta associação das informações.
- Se houver mais de um valor na mesma célula, os itens devem ser separados por ponto e vírgula (;), sem espaços.
Passo 4 - Verifique o que deseja fazer: criar novas SKUs ou editar as existentes?
Para criar novas SKUs, além dos pontos já mencionados, confira as colunas "ID" e "id_produto":
"id": deve permanecer preenchido para produtos já existentes. Se for um novo produto, deixe essa coluna vazia.
"id_produto": todas as variações de um mesmo produto devem ter o mesmo ID nessa coluna. O valor só muda ao começar o cadastro de variantes de um novo produto.
Para atualizar, basta substituir os dados necessários, seguindo as regras mencionadas anteriorment
Passo 5 - Copie todos os dados da planilha e cole sem formatação em uma planilha nova. Tente importar a planilha novamente.
Passo 6 - Caso ainda assim não funcione, pode estar ocorrendo alguma lentidão na fila de importação. Entre em contato com a nossa equipe de suporte.
Dúvidas frequentes 🤔
▶️Clique na setinha de cada um pra abrir o conteúdo*
Estou com problemas para importar minha planilha, o que fazer?
Estou com problemas para importar minha planilha, o que fazer?
Verifique as regras e especificações que descrevemos nesse artigo e verifique esses pontos:
Passo 1 - Verifique se a planilha contém todas as colunas de preenchimento obrigatórios*:
- id (se for um produto já existente, para novas SKUs deve permanecer em branco)
- id_produto
- nome_produto
- disponivel_para_venda
- sku
Passo 2 - Para as colunas “valores_de_variacoes” e “customizacoes”:
- Os dados devem estar previamente cadastrados no painel da Yampi. A planilha não cria essas informações, apenas vincula ao produto.
- Na planilha, os nomes de cada uma dessas customizações do produto devem ser escritas exatamente como foram cadastradas na Yampi. Isso inclui letras maiúsculas e minúsculas, espaços e caracteres especiais. Qualquer diferença pode impedir a correta associação das informações.
- Se houver mais de um valor na mesma célula, os itens devem ser separados por ponto e vírgula (;), sem espaços.
Passo 4 - Verifique o que deseja fazer: criar novas SKUs ou editar as existentes?
Para criar novas SKUs, além dos pontos já mencionados, confira as colunas "ID" e "id_produto":
"id": deve permanecer preenchido para produtos já existentes. Se for um novo produto, deixe essa coluna vazia.
"id_produto": todas as variações de um mesmo produto devem ter o mesmo ID nessa coluna. O valor só muda ao começar o cadastro de variantes de um novo produto.
Para atualizar, basta substituir os dados necessários, seguindo as regras mencionadas anteriorment
Passo 5 - Copie todos os dados da planilha e cole sem formatação em uma planilha nova. Tente importar a planilha novamente.
Passo 6 - Caso ainda assim não funcione, pode estar ocorrendo alguma lentidão na fila de importação. Entre em contato com a nossa equipe de suporte.
Estou migrando para Yampi, e tenho uma planilha de skus da minha antiga loja. Posso usar essa planilha para importar meusskus na Yampi?
Estou migrando para Yampi, e tenho uma planilha de skus da minha antiga loja. Posso usar essa planilha para importar meusskus 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.
Em caso de dúvidas, clique no balãozinho de atendimento em seu painel ou nos encaminhe pelo e-mail para [email protected] 😉