# Importar novo catálogo: o assistente passo a passo

> Para o administrador: importe o catálogo completo por planilha com o assistente e revise o mapeamento de colunas, abas, variantes e tabelas de preço.

Fonte: https://vendria.com/ajuda/importar-novo-catalogo-passo-a-passo

## Onde fica

No menu da sua conta, em **Catálogo e Preços**, aba **Importação** → botão
**Importar planilha** → **Importar novo catálogo**.

⚠️ Este é o caminho que **substitui** o catálogo: produtos que não estiverem na
planilha são desativados. Para só acrescentar ou corrigir, use **Atualizar
catálogo existente**. Ver [Atualizar catálogo existente: acrescentar sem remover nada](/ajuda/atualizar-catalogo-existente).

## Passo a passo da importação completa

1. Confira a loja no seletor **Loja** do topo do hub.
2. Clique em **Importar planilha** e escolha **Importar novo catálogo**.
3. Na janela **Importar Produtos**, arraste o arquivo ou clique para selecionar
   (`.xlsx`, `.xls` ou `.csv`). Se precisar de um ponto de partida, use
   **Baixar modelo**.
4. Clique em **Analisar**. O assistente lê a planilha e detecta as colunas
   sozinho.
5. Na tela **Revisão do Mapeamento**, confira e corrija o que ele entendeu
   (detalhes nas seções abaixo).
6. Clique em **Importar (N linhas)**. A janela mostra **Importando catálogo...**
   com as etapas e a barra de progresso.
7. No fim, **Importação concluída** mostra quantos produtos foram
   **Adicionados**, **Atualizados** e **Removidos**, mais os avisos.

O botão **Importar** só se habilita quando há uma coluna de **SKU / Código** ou
de **Descrição** mapeada. **Voltar** retorna à escolha do arquivo sem gravar
nada.

## A tela Revisão do Mapeamento

No título, ao lado de **Revisão do Mapeamento**, um selo com percentual diz
quanto o assistente confia na leitura: verde a partir de 90%, amarelo a partir
de 70%, vermelho abaixo disso. Abaixo do título vêm o nome do arquivo, o número
de linhas e de colunas e, quando o mapeamento foi reaproveitado de uma
importação anterior, **(mapeamento em cache)**.

Faixas amarelas ou vermelhas no topo são avisos do assistente: campo
obrigatório não encontrado, confiança baixa. A faixa **N colunas requerem
atenção** lista colunas classificadas com confiança baixa: confira cada uma.

**Mapeamento de colunas** liga os campos do sistema (**SKU / Código**,
**Descrição**, **Preço**, **Estoque**) às colunas da planilha. Em cada campo dá
para trocar a coluna ou escolher **Nenhum**. Ao lado de **Preço**, **Vários
preços** transforma a coluna em tabelas de preço; ao lado de **Estoque**,
**Vários locais** separa o estoque por local.

## Planilha com várias abas

Quando o arquivo tem mais de uma aba, aparece **Abas para importar**, com uma
caixa de marcar por aba e o número de linhas de cada uma. Cada aba tem o próprio
mapeamento: clique no nome da aba para revisar o dela.

- Aba sem coluna de código ou descrição reconhecida vem desmarcada, com o aviso
  **Esta aba está desabilitada**.
- Em **Nome da aba**, a opção **Salvar como atributo "aba"** grava em cada
  produto o nome da aba de onde ele veio.
- Um mesmo código em duas abas marcadas: vale o da última aba.

## Classificar as outras colunas

As colunas que não são código, descrição, preço ou estoque aparecem em
**Atributos para importar** e, recolhidas, em **Campos ignorados (N)**. Cada uma
mostra **Preenchimento**, **Valores** e **Exemplos**, e tem um seletor de
**Classificação**:

- **Ignorar**: a coluna não entra;
- **Atributo**: vira um atributo do produto (marca, aplicação, cor);
- **Coleção**: agrupa os produtos em coleções pelo valor da coluna (uma coluna
  só);
- **Variante**: a coluna define variantes (cor, tamanho) de um mesmo produto;
- **Ref. cruzada**: códigos de outras marcas para o mesmo produto, usados na
  busca;
- **Imposto**: a coluna traz uma alíquota ou valor de imposto;
- **Tabela de preço**: a coluna é mais um preço (vira uma tabela);
- **Unidade e Embalagem**: unidade de venda ou quantidade por embalagem.

Colunas quase vazias ou com um valor só aparecem esmaecidas: normalmente é
melhor ignorá-las.

## As seções especiais da revisão

Conforme a planilha, aparecem seções próprias:

- **Preço e Embalagem**: de qual coluna vem a unidade de venda e a quantidade
  por embalagem, e se o preço se refere à embalagem ou à unidade. Ver [Unidade, embalagem e múltiplo de venda do produto](/ajuda/unidade-embalagem-e-multiplo).
- **Variantes**: a dimensão detectada e as colunas classificadas como variante.
- **Estoque por local**: uma sigla por local (ex.: SP, SC) ligada à coluna de
  estoque dele; **Adicionar localização** acrescenta, **Usar coluna única** volta
  a um estoque só.
- **Imagens**: **Importar imagens (N detectadas)** quando a planilha tem fotos
  dentro das células ou uma coluna de link de imagem.
- **Referências cruzadas (SKUs alternativos)**: coluna, **Marca / Label** e a
  caixa **Importar** de cada uma.
- **Tabelas de preço**: uma linha por coluna de preço. Ver [Carregar os preços das tabelas por planilha](/ajuda/precos-das-tabelas-por-planilha).
- **Impostos detectados**: cada coluna de imposto com o **Tipo** (**Percentual**,
  **Valor fixo** ou **Derivado**) e a **Interpretação** do percentual.
- **Amostra dos dados**: as primeiras linhas, só com as colunas que vão entrar.

No fim da revisão, a faixa laranja **Existem N produtos cadastrados. Produtos
que não estiverem na planilha serão removidos.** lembra o que está em jogo.

## O resultado da importação

A tela **Importação concluída** mostra os três números e, quando houver:

- a lista de **Avisos:** linhas que não entraram, por exemplo "SKU e descrição
  ausentes";
- **SKUs duplicados:** códigos repetidos na mesma aba; a primeira linha foi
  mantida;
- a mensagem de campos preservados pelo ERP;
- "N produto(s) saíram da promoção", quando uma coluna promocional foi
  reimportada;
- o aviso de que a busca pode estar desatualizada, quando a atualização do índice
  de busca falhou.

Feche com **Fechar**. Os avisos continuam visíveis depois, na faixa **Última
importação com N avisos** da aba **Contexto**.

## Quando dá errado

**"O botão Importar está cinza."** Falta mapear **SKU / Código** ou
**Descrição**. Com várias abas, pelo menos uma aba marcada precisa ter um dos
dois.

**"O assistente trocou as colunas."** Corrija na **Revisão do Mapeamento** antes
de importar. Na próxima importação da mesma loja, o mapeamento que você
confirmou é reaproveitado.

**"Arquivo muito grande. Máximo permitido: 20MB"**, ou uma aba que "excede o
limite" de 20 mil linhas: divida a planilha em arquivos menores. A primeira
parte vai pela **Importar novo catálogo**; as seguintes, pela **Atualizar
catálogo existente**, senão cada arquivo desativaria os produtos dos anteriores.

**"Apareceu 'A busca pode estar desatualizada'."** Os produtos foram gravados,
mas o índice de busca não acompanhou. Os dados estão certos; se a busca não
achar um produto novo, importe de novo ou fale com o suporte.
