Importação e exportação de produtos e SKUs via planilha (Beta)
11 min de leitura
Essa funcionalidade está em fase Beta, o que significa que estamos trabalhando para aprimorá-la. Em caso de dúvidas, entre em contato com nosso Suporte.
No Admin VTEX, você pode gerenciar a importação e a exportação de produtos e SKUs utilizando planilha, conforme apresentado nas seções:
- Importar produtos e SKUs via planilha
- Exportar produtos e SKUs via planilha
- Acompanhar janela do processo de exportação
- Ver campos da planilha de produtos e SKUs
Para saber como gerenciar manualmente pelo Admin VTEX os seus produtos e SKUs, veja os artigos Adicionar ou editar produto e Adicionar ou editar SKU. Para informações sobre integrações de backend com ERP, confira o guia Back office integration guide (ERP/PIM/WMS).
Importar produtos e SKUs via planilha
Para importações de produtos e SKUs por planilha, realize os seguintes passos:
- No Admin VTEX, acesse Catálogo > Produtos e SKUs, ou digite Produtos e SKUs na barra de busca no topo da página.
- No topo da página, clique em
Importar. - Clique em
Produtos e SKUs. - Na janela aberta, clique em Baixe o modelo de planilha de importação aqui para obter o arquivo.
- Preencha os dados da planilha, conforme orientado na seção Ver campos da planilha de produtos e SKUs.
- Adicione a planilha com extensão
.xlsou.xlsx. Você pode arrastar o arquivo e soltá-lo sobre a área indicada, ou clicar sobre a janela e selecionar o arquivo localmente. - Clique em
Importar.
O tempo da operação vai depender do volume de informação sendo processada. A importação não será afetada, caso você saia da página.
Enquanto a operação estiver em andamento, aparecerá a mensagem de que o arquivo está sendo processado. Após a conclusão da operação, você verá a mensagem "Produtos e SKUs importados com sucesso", e receberá um email de confirmação.
Exportar produtos e SKUs via planilha
Para exportar um arquivo .xlsx com informações sobre o seu sortimento de produtos e SKUs, realize os seguintes passos:
As informações exportadas correspondem aos campos apresentados na seção Ver campos da planilha de produtos e SKUs.
- No Admin VTEX, acesse Catálogo > Produtos e SKUs, ou digite Produtos e SKUs na barra de busca no topo da página.
- (Opcional) Caso queira exportar uma seleção de produtos e SKUs, busque ou filtre os itens desejados. Este passo não é necessário para exportar todos os produtos e/ou SKUs.
- No topo da página, clique em
Exportar. - Clique em
Produtos e SKUs. - No modal de Exportação, selecione o ícone caixa correspondente aos Campos de produto e/ou Campos de SKU, conforme desejado. Os campos obrigatórios não podem ser desmarcados.
Somente planilhas que foram exportadas com todos os campos podem ser importadas futuramente.
- Clique em
Exportar.
Enquanto a operação estiver em andamento, aparecerá a mensagem de que o arquivo está sendo processado. Mesmo que você saia da página, a operação não será interrompida. Você pode acompanhar o andamento da exportação pela janela que surge na página, como será apresentado na próxima seção.
Após a finalização da exportação, você receberá um email com um link para fazer o download do arquivo. O prazo para o download pelo link é de 24 horas, após este período o link expira. Também é possível baixar o arquivo pela janela que surgiu na página.
Acompanhar janela do processo de exportação
Enquanto a exportação estiver sendo processada, a página Produtos e SKUs apresentará uma janela na parte inferior como a imagem a seguir:
- Exportações 1: informa o número de operações de exportação sendo realizadas, neste caso apenas uma.
- Ícone de carregando: indica que a operação de exportação está em andamento.
- Produtos e SKUs: identifica o tipo da exportação. Outras operações que existem são exportações de especificações de produtos, especificações de SKUs e imagens de produtos e SKUs.
- Data e hora: apresentam o horário do início da exportação, no formato
DD-MM-AAAA - hh:mm. - Número em tag azul: informa a quantidade de itens sendo exportados.
- (Opcional) Ícone seta para baixo : aparece quando há mais de uma exportação em andamento e, quando clicado, minimiza a visualização da janela, de forma que ela pode voltar a se expandir.
- Ícone fechar : quando clicado, fecha a visualização da janela, mas não interfere na exportação em andamento.
- Ícone cancelar : quando clicado, cancela a exportação.
Após a conclusão da operação, a janela apresentará as seguintes mudanças:
- Ícone verde: indica que a exportação foi finalizada.
- Ícone fechar : quando clicado, fecha a visualização da janela, sem a opção de voltar a expandi-la.
- Ícone para download : quando clicado, baixa o arquivo
.xlsxno dispositivo.
Ver campos da planilha de produtos e SKUs
A tabela a seguir apresenta a descrição e o exemplo de preenchimento dos campos da planilha de importação de produtos e SKUs. Campos obrigatórios estão marcados com um asterisco (*).
Ao preencher os campos Nome Produto, Departamento, Categoria e Marca, evite utilizar as palavras reservadas listadas a seguir, pois isso pode comprometer o funcionamento da sua loja e do seu Admin VTEX:
- a
- meta
- api
- admin
| Campo | Descrição | Exemplo |
|---|---|---|
| ID Produto | Número único identificador do produto. Caso esse campo já esteja preenchido, não é possível alterá-lo. Para adicionar um novo produto, deixe o campo vazio. | 310117603 |
| Nome Produto* | Nome do produto apresentado para os clientes na experiência de navegação, podendo ter até 150 caracteres. Por questões de SEO, recomendamos:
| Corebiz camiseta |
| Produto ativo | Informa se o status do produto será ativo ou inativo. Este campo não editável pela planilha, deve ser deixado vazio. | |
| Descrição | Texto com informações gerais sobre o produto. Este conteúdo é apresentado aos clientes na vitrine da loja, portanto recomendamos criar um resumo de fácil entendimento. | O modelo tem gola redonda e as mangas são curtas. |
| Descrição adicional | Conteúdo adicional do produto, como informações resumidas. Recomendamos não ultrapassar 150 caracteres, de forma que os mecanismos de busca mostrem o texto completo nas páginas de resultado. | Material 70% reciclado |
| ID Marca* | Código numérico que identifica a marca do produto. Esta informação pode ser encontrada no Admin VTEX, em Catálogo > Marcas, ou usando o endpoint Get brand list. | 2000003 |
| Marca | Nome da marca do produto. Uma vez preenchido, este campo não pode ser editado. | AOC |
| ID Departamento | Código numérico que identifica a categoria de maior nível hierárquico do produto. Este campo não é editável pela planilha. Em caso de um novo produto, deixe o campo vazio. | 1000014 |
| Departamento | Nome da categoria de maior nível hierárquico do produto. | Roupas |
| ID Categoria* | Número único identificador da categoria de menor nível hierárquico do produto. Essa informação pode ser encontrada no Admin VTEX, em Catálogo > Categorias, ou usando o endpoint Get category tree. | 1000014 |
| Categoria | Nome relacionado à categoria de menor nível hierárquico do produto. É possível mover o produto de uma categoria para outra. | Blusas |
| Políticas comerciais | Número único identificador da política comercial. Essa informação pode ser encontrada no Admin VTEX, em Configurações de loja > Políticas comerciais. Para múltiplas políticas comerciais, separe os números por vírgula sem usar espaço. | 1,2,7 |
| ID Categoria global | Código identificador da categoria global do produto, ou seja, a taxonomia criada pelo Google para o Merchant Center, que fica pré-definida como uma árvore única na plataforma VTEX. Este campo é importante para questões de SEO. | 166 |
| Categoria global | Nome da categoria global. | Vestuário e acessórios |
| Título da página | Nome escolhido para aparecer tanto na página de detalhes do produto (PDP) quanto na aba do navegador. Este campo é especialmente importante para SEO. O limite são 150 caracteres. | Corebiz camiseta azul gola redonda |
| Meta descrição | Breve descrição do produto, preferencialmente usando menos de 160 caracteres. Isso permite que os mecanismos de busca possam apresentar a descrição de forma correta nas páginas de resultados. | Corebiz camiseta azul gola redonda em poliéster e lycra feita com 70% de material reciclado |
| Mostrar no site* | Se você deseja que o produto esteja visível na vitrine, preencha sim. Se prefere que ele fique oculto, preencha com não. | sim |
| Mostrar quando estiver fora de estoque* | Se deseja que o produto esgotado apareça na vitrine, preencha com sim. Isso permite usar a configuração Avise-me para que o cliente informe seu email e seja avisado quando o produto estiver disponível. Se prefere que o produto esgotado se torne oculto na vitrine, preencha com não. | não |
| Data de lançamento | Data e hora na qual o produto será disponibilizado para venda. Este campo auxilia a ordenação de resultados de busca do site, influencia a criação de coleções automáticas e determina a data de indexação do produto. O formato aceito é AAAA-MM-DD hh:mm:ss. | 2025-11-25 10:30:00 |
| Palavras substitutas | Sinônimos do nome do produto, que permitem buscas mais abrangentes. O limite é de 8.000 caracteres, incluindo caracteres especiais. Para adicionar diversas palavras, separe-as por vírgula sem espaço. | camisa,blusa |
| Código de referência Produto | Código de referência único do produto, utilizado apenas internamente pela loja. Para preencher este campo, use uma combinação única de letras e/ou números. | 68ce4_azul |
| Código fiscal | Sequência numérica que identifica o produto. | 84509010 |
| ID SKU | Código numérico único que identifica o SKU. Caso esse campo já esteja preenchido, não é possível alterá-lo. Para adicionar um novo SKU, deixe o campo vazio. | 310119261 |
| Nome SKU* | Nome do SKU, ou seja, que identifica a variação do produto. | M |
| Ativar SKU se possível* | Se deseja a ativação automática do SKU após a checagem dos requisitos de disponibilidade, preencha com sim. Se não deseja que ele seja ativado, preencha com não. | sim |
| SKU Ativo | Este campo define se o SKU está ativo (sim) ou inativo (não). O campo não permite alteração e é utilizado somente para consulta. | não |
| Kit | Este campo define se o SKU é um kit. A ação de transformar um SKU em kit é irreversível. Caso esteja criando um novo SKU, deixe o campo vazio. | |
| Código de referência SKU | Código de referência único do SKU, criado para auxiliar o lojista na gestão do catálogo. Após ser criado, não é possível editá-lo pela planilha.Este campo é obrigatório, a menos que o campo EAN/UPC tenha sido preenchido. | |
| EAN/UPC | O EAN (European Article Number) e o UPC (Universal Product Code) são códigos de identificação internacionais e correspondem ao código de barras de um item. Cada SKU só pode ser associado a um deles e é possível diferenciá-los pelo número de caracteres alfanuméricos, que são 13 para o EAN e 12 para o UPC.Este campo é obrigatório, a menos que o campo Código de referência SKU tenha sido preenchido. | 8456971345604 |
| Código do fabricante | Código fornecido pelo fabricante para identificar o SKU. Caso algum SKU tenha um código específico, esse campo deve ser preenchido. | 7154-azul |
| Peso do pacote* | Valor absoluto de peso do pacote. | 0,8 |
| Largura do pacote* | Valor absoluto da largura do pacote. | 12 |
| Altura do pacote* | Valor absoluto da altura do pacote. | 5 |
| Comprimento do pacote* | Valor absoluto do comprimento do pacote. | 25 |
| Peso real | Valor absoluto do peso do produto, desconsiderando embalagens. | 0,6 |
| Largura real | Valor absoluto da largura do produto, desconsiderando embalagens. | 0,1 |
| Altura real | Valor absoluto da altura do produto, desconsiderando embalagens. | 1,2 |
| Comprimento real | Valor absoluto do comprimento do produto, desconsiderando embalagens. | 0,9 |
| Peso cúbico | Este campo não é mais utilizado pelo sistema e deve ser deixado vazio. | |
| Unidade de medida* | Identificação da unidade de medida considerada para a contagem de itens em estoque. Em geral, deve ser preenchido com un, referente à unidade. Utilize um valor diferente apenas se for necessário converter a unidade de medida para a venda. Os valores permitidos são:
| un |
| Multiplicador de unidade* | Valor numérico pelo qual o SKU será multiplicado para definir a quantidade no carrinho. Por exemplo, o multiplicador 5 significa que cada SKU representa 5 volumes no carrinho, permitindo somente compras de múltiplos de 5, como 10 ou 15 volumes. Valores fracionados podem ser separados tanto por ponto quanto por vírgula. Por exemplo, metade de um quilograma pode ser 0.5 ou 0,5. | 1 |
| Condição comercial | Código numérico único identificador da condição comercial, que define quais promoções ou condições de pagamento devem ser válidas para o SKU. | Padrão |
| Valor fidelidade | Crédito que o cliente recebe ao concluir uma compra de 1 unidade de determinado SKU. Por exemplo, preenchendo este campo com o valor R$1,00, o cliente que adquirir este SKU vai obter um crédito de R$1,00 na loja para compras futuras. Esse campo deve ser preenchido com valores decimais da moeda padrão da loja. | 49,90 |
| Data de pré-venda | Data de pré-venda atribuída ao SKU, ou seja, a data prevista para a chegada do item nas lojas e sua disponibilização para venda. Para realizar essa configuração, é preciso considerar tanto a data de lançamento do item quanto o cálculo do envio do item para os clientes. O formato aceito é AAAA-MM-DD hh:mm:ss. | 2025-10-30 10:30:00 |
| Anexos | Nome do anexo que pode ser selecionado pelo cliente como customização do SKU. | Customizar nome |
| Acessórios | Itens sugeridos como opções complementares para a venda. Para adicionar um item acessório, inclua o ID do SKU. Se quiser incluir diversos SKUs, separe-os usando vírgula sem espaço. | 320221270 |
| Sugestões | Itens apresentados como sugestões de compra. Para adicionar um item de sugestão, inclua o ID do SKU. Se quiser incluir diversos SKUs, separe-os usando vírgula sem espaço. | 320221279,320221280 |
| Produtos similares | Itens ofertados como uma alternativa de compra ou simplesmente algo similar. Para adicionar um item similar, inclua o ID do SKU. Se quiser incluir diversos SKUs, separe-os usando vírgula sem espaço. | 320221284 |
| Mostrar junto | Itens sugeridos para serem adquiridos conjuntamente. Para adicionar um item para mostrar junto, inclua o ID do SKU. Se quiser incluir diversos SKUs, separe-os usando vírgula sem espaço. | 320221293,320221294 |