Importando e Exportando produtos com as planilhas

As planilhas do Catálogo exportam e importam produtos em massa. A aba Planilhas fica em Extensões → Catálogo, com Baixar Planilha vazia, Baixar Planilha com produtos e Subir Planilha. O ritual do dia a dia (quando exportar e importar) está em Planilhas do catálogo na prática. Este artigo detalha cada coluna.

Atenção especial às tags: teto de 120 por produto, formato [tag1][tag2], e tags inválidas não apagam as tags já salvas.

Detalhes de cada campo e cuidados

O Interago planilha é bem rígido com o formato.Se algum campo obrigatório estiver vazio ou mal formatado, a importação para e mostra erro.Abaixo explico, em linguagem simples, o que cada coluna significa e como preencher para funcionar.

1. Colunas obrigatórias da planilha

A planilha precisa ter uma aba chamada iCatalog.Na primeira linha dessa aba, o cabeçalho deve ser exatamente assim (nessa ordem):

1. ID (PRODUTO OU VARIACAO idFilho-idPai)
2. TIPO
3. TITULO
4. DESCRIÇÃO
5. IMAGEM
6. PREÇO
7. QUANTIDADE
8. MARCA
9. SKU
10. GTIN
11. MPN
12. PESO
13. MEDIDAS (SEPARADOS POR CHAVE)
14. CÓDIGO DA CATEGORIA
15. CÓDIGO CATEGORIAS ADICIONAIS (SEPARADOS POR CHAVE)
16. TAGS (SEPARADAS POR CHAVE)
17. DISPONIBILIDADE
18. (daqui em diante) Filtros personalizados (se existirem)

Não mude o nome dessas colunas nem a ordem.Se você criou filtros de produto no Interago, o sistema adiciona automaticamente mais colunas, com nomes começando por # (por exemplo: #10-COR (SIMPLES)).

2. Campo por campo - o que colocar

ID (PRODUTO OU VARIACAO idFilho-idPai)

• Para produtos novos: pode ficar em branco.

• Para produtos já existentes: vem preenchido na planilha que você baixa do Interago.

• Para variações, o Interago espera uma relação com o produto pai.

O comentário diz “idFilho-idPai”, mas o fluxo prático é: normalmente você baixa a planilha do Interago, mantém esse campo como veio, e não inventa ID manualmente. Como regra simples para quem é leigo:Se você está começando do zero, pode deixar em branco nas linhas de produto.Se está atualizando produtos já existentes, não mexa nesse campo.TIPOEste campo é crítico. O Interago só aceita duas palavras exatas:

• produto

• variacao

Se estiver vazio, ou com qualquer outra escrita (ex.: “prod”, “variação” com acento etc.), a importação dá erro.Use assim:

• Linhas de produto “principal”: produto.

• Linhas de variação (ex.: tamanho P, M, G): variacao.

TITULO

• É o nome do produto ou da variação.

• Obrigatório para:

• linhas com TIPO = produto,

• linhas com TIPO = variacao.

Use um texto claro, como aparece na loja.Não tem limite curto no código, mas evite textos exageradamente longos.

DESCRIÇÃO

• É o texto descritivo do produto.

• Pode ter parágrafos, mas é sempre um texto simples na célula.

O Interago não trava por causa da descrição, mas tenha cuidado com colagens muito “sujas” (com quebras estranhas, tags quebradas, etc.).

IMAGEM

• É o link da imagem principal do produto ou da variação.

• Deve ser uma URL completa (por exemplo, começando com https://...).

Se você não tiver a imagem ainda, pode deixar vazio e configurar depois pelo painel.Mas se preencher, use um link válido.

PREÇO

• Valor numérico com 2 casas decimais.

• Exemplo correto:

• 199.90

• 59.00

O Interago espera que esse valor possa ser entendido como preço.Se você colocar caracteres não numéricos (exceto ponto ou vírgula), ele pode falhar.

QUANTIDADE

• É o estoque daquele produto ou variação.

• Valor inteiro (0, 1, 2, 10, 100…).

Se deixar vazio, o sistema interpreta como nenhuma quantidade informada.Para evitar confusão, coloque um número inteiro sempre.

MARCA

• Nome da marca do produto.

• Obrigatório para linhas de produto.

• Deve ter até 100 caracteres.

Se ficar vazio ou muito longo, o Interago acusa erro nessa linha.

SKU

• É o código interno da empresa para o produto.

• Obrigatório para:

• • produto,

• • variacao.

• Deve ter até 100 caracteres.

• Não pode repetir de forma incoerente:

• • um SKU de produto não pode ser reutilizado como SKU de variação de outro produto.

• • o sistema cruza SKU/GTIN/MPN de produto x variação e impede conflitos.

Regra simples:Cada produto/variação deve ter um SKU único, consistente com o que você já usa na loja ou em outros sistemas.

GTIN

• É o código de barras internacional (EAN, UPC, etc.).

• Campo opcional.

• Até 100 caracteres.

Se você não usa GTIN, pode deixar vazio.Se usar, não deixe maior que 100 caracteres e evite caracteres estranhos.

MPN

• É o código do fabricante.

• Campo opcional.

• Até 100 caracteres.

Semelhante ao GTIN: use se você já trabalha com esse identificador.Evite repetir um MPN de forma que gere conflito entre produtos diferentes.

PESO

• Peso do produto ou variação.

• Aceita número com até 3 casas decimais.

• Pode usar ponto ou vírgula, o código converte internamente.

Exemplos:

• 1

• 1.25

• 0,750

MEDIDAS (SEPARADOS POR CHAVE)

Este campo é mais sensível. O Interago espera 4 valores entre colchetes. O formato esperado é algo como:

• [largura][altura][profundidade][valor extra]

Exemplo:

• [10][20][5][0]

Regras que o Interago aplica:

• Divide o conteúdo pelos colchetes.

• Precisa encontrar exatamente 4 partes.

• As 3 primeiras devem ser números válidos (aceita vírgula ou ponto).

• A quarta também precisa ser número ou pode ser vazia, mas não pode ser texto.

Se esse padrão estiver quebrado, a importação para e mostra erro de “campo MEDIDAS inválido” naquela linha.Se você não quiser usar medidas, deixe o campo vazio.Se usar, siga sempre o formato de 4 colchetes.

CÓDIGO DA CATEGORIA

• É o ID numérico da categoria no Interago.

• Obrigatório para produto.

• Tem que ser número inteiro.

Se você baixou a planilha do Interago, esse campo já vem preenchido corretamente. Ao criar do zero, é muito fácil errar esse código. Por isso, para quem é leigo, o mais seguro é:

• Criar a categoria pelo painel.

• Cadastrar o produto pelo painel ou

• Baixar a planilha pronta do Interago e usar os códigos que já vêm nela.

Se colocar letras ou qualquer coisa que não seja número, o Interago acusa erro de categoria inválida.

CÓDIGO CATEGORIAS ADICIONAIS (SEPARADOS POR CHAVE)

• Lista de IDs de categorias adicionais, também numéricos.

• Formato: valores entre colchetes.

Exemplos:

• [2][5][8]

• [10]

Regra:

• Cada valor entre colchetes precisa ser um número inteiro.

• Se tiver letra ou símbolo estranho, o Interago mostra erro de “categorias adicionais inválidas”.

Se não tiver categorias adicionais, pode deixar em branco.

TAGS (SEPARADAS POR CHAVE)

• Lista de palavras-chave do produto.

• Formato na planilha: [tag1][tag2] (cada tag entre colchetes, uma após a outra).

Exemplos:

• [promoção][oferta][lançamento]

• [camiseta][algodão]

Regras importantes:

• No máximo 120 tags distintas por produto. Se passar: Informe no máximo 120 tags distintas por produto.
• Cada tag: mínimo 2 e máximo 45 caracteres.
• Todas ficam dentro de colchetes, uma após a outra.

Se qualquer tag passar do tamanho ou a lista for inválida, a importação rejeita a linha com mensagem do tipo: Tags inválidas. Esta linha não foi importada e as tags atuais do produto não foram alteradas. Ou seja: tag inválida não limpa as tags já salvas.

Se a gravação falhar depois da validação: Não foi possível gravar as tags. As tags atuais do produto não foram alteradas.

Quando a lista é válida, a importação substitui o conjunto de tags do produto pelo da planilha. Para manter as tags atuais, não envie a coluna vazia sem querer (célula vazia no replace pode zerar tags).

Se não quiser mudar tags nesta importação, deixe a coluna como veio no export ou não altere o campo.

DISPONIBILIDADE

• Texto que indica se o produto está disponível.

• O código considera valores como:

• Disponivel

• Indisponivel

Escreva exatamente esses termos (sem acento), para evitar comportamento estranho. Se estiver “Disponivel”, a loja entende que está à venda.Se estiver “Indisponivel”, pode tratar como esgotado/inativo.

3. Colunas extras - filtros personalizados

Depois da coluna DISPONIBILIDADE, o Interago acrescenta uma coluna para cada filtro que você criou no catálogo.Os nomes vêm assim:

• #ID-NOME(TIPO)

• Exemplo: #10-COR(SIMPLES)

• Exemplo: #12-MATERIAL(TEXTO)

O “TIPO” indica como o filtro é tratado internamente:

• SIMPLES

• TEXTO

• MEDIAS

• HTML

Para quem é leigo, a regra é:

• Preencher cada uma dessas colunas com um valor coerente com o que já existe na loja.

• Se for filtro simples (ex.: COR), use valores parecidos com o que você escolheria no painel (ex.: “Azul”, “Vermelho”).

• Se não souber como mexer, mantenha os valores que vieram na planilha exportada do Interago.

4. Regras específicas para PRODUTOS x VARIAÇÕES

Linhas com TIPO = produtoPara produtos “principais”, o Interago exige:

• TITULO preenchido

• MARCA preenchida

• CÓDIGO DA CATEGORIA preenchido (e numérico)

• SKU preenchido

Se algum desses estiver vazio, dá erro de célula obrigatória vazia.Além disso, verifica conflitos:

• Se o mesmo SKU/GTIN/MPN já estiver usado em uma variação, ele bloqueia a importação dessa linha.

Linhas com TIPO = variacaoPara variações, o Interago exige:

• ID preenchido (ligação com o produto)

• TITULO preenchido

• SKU preenchido

E ainda:

• Confere se essa variação não está tentando usar um SKU/GTIN/MPN que já pertence a outro produto ou variação “incompatível”.

• Confere se a variação está realmente ligada a um produto pai já entendido pelo sistema.

Na prática, o caminho mais seguro é:

• Baixar a planilha com produtos e variações já cadastrados.

• Editar em cima dela.

• Evitar criar variações “do zero” em planilha se você não domina bem os IDs internos.

5. Outros cuidados técnicos importantes

• O arquivo .xlsx não pode passar de 4 MB.

Se passar, o sistema recusa e você precisa dividir em vários arquivos menores.

• A aba precisa chamar iCatalog.

Se você renomear para outro nome, o Interago entende como planilha incompatível.

• Não adicione colunas novas e não apague colunas existentes do modelo do Interago.

Qualquer mudança na estrutura faz o Interago entender que “o número de colunas não confere”.

• Tente sempre trabalhar em cima da planilha que você baixou da própria loja, em vez de criar do zero.