Importar e atualizar produtos com uma planilha#

Baixe um modelo de categoria, preencha-o com seus produtos e carregue-o no Catálogo. Este fluxo não exige escrever código nem usar credenciais de API.

Antes de começar#

Selecione a loja correta no Painel. Você precisa de permissão para editar seu catálogo. Se o botão Carregar planilha de produtos estiver ausente, verifique a loja selecionada, sua permissão de escrita no catálogo e se sua conta tem acesso somente de leitura.

Baixe o modelo de categoria#

Abra Painel → Catálogo.
Clique em Carregar planilha de produtos para abrir a caixa de diálogo Importar produtos.
Em Escolha a categoria do produto, selecione a categoria que deseja importar. As opções dependem da configuração da sua loja.
Clique em Baixe o modelo do Excel. Use um modelo e um envio separados para cada categoria.

Baixe um modelo novo ao preparar uma nova importação para que suas colunas correspondam aos requisitos atuais da categoria. A pasta de trabalho baixada é um modelo, não uma exportação do seu catálogo existente.

Preencha a pasta de trabalho#

Use as planilhas da pasta de trabalho da seguinte forma:

Planilha	Finalidade
`Products`	Insira seus dados reais de produto a partir da linha 2. Mantenha a primeira linha com os nomes dos campos inalterada.
`Instructions`	Leia os campos obrigatórios, dimensões e regras específicas da categoria.
`Enums`	Consulte os valores aceitos para campos como `status` e `dimension_unit`.
`Examples`	Consulte exemplos válidos e inválidos. Insira seus produtos reais em `Products`, não aqui.

Cada linha de produto deve conter sku, name, image_url e product_url, além das dimensões obrigatórias para sua categoria. Siga os marcadores de campos obrigatórios e as instruções no modelo baixado. Não traduza nomes de campos nem adicione colunas desconhecidas ou duplicadas.

Mantenha as células de SKU como texto para que o software de planilha não remova zeros à esquerda ou altere identificadores longos. Use uma linha por SKU; valores duplicados no mesmo arquivo são rejeitados, incluindo valores que diferem apenas no uso de maiúsculas e minúsculas.
Use um endereço de imagem HTTP ou HTTPS direto e publicamente acessível para image_url; ele deve funcionar sem login, cookies ou cabeçalhos de solicitação personalizados. Coloque o endereço da página de detalhes do produto em product_url.
Especifique dimensões e unidades usando as instruções do modelo. Se nenhuma unidade for fornecida em uma dimensão ou em dimension_unit, o padrão é in.
Escolha status entre os valores aceitos em Enums. Deixá-lo em branco usa active como padrão; defina-o explicitamente ao atualizar produtos.

Salve como .xlsx (recomendado). .csv também é aceito se contiver apenas a linha de cabeçalho do produto e dados. Arquivos antigos .xls não são compatíveis. Cada arquivo pode conter até 50,000 linhas de produto não vazias e não pode ter mais de 50 MB.

Carregue e verifique o resultado#

Retorne à caixa de diálogo de importação e selecione a mesma categoria do modelo.
Em Preencher e carregar, escolha seu arquivo salvo e clique em Iniciar importação.
Em Importações recentes, confira o nome do arquivo, o status do processamento e a quantidade de linhas bem-sucedidas e com falha. O envio confirma a aceitação do arquivo; o processamento continua em segundo plano.
Aguarde o término do processamento e verifique se há linhas com falha mesmo se a tarefa mostrar Concluído. Volte ao Catálogo para verificar os dados dos produtos importados e se estão prontos para visualização.

Se houver linhas com falha, clique em Arquivo de falha, examine as mensagens de erro, corrija os dados do produto e carregue o arquivo corrigido com a mesma categoria. A pasta de trabalho de falhas baixada contém as linhas com falha e colunas de diagnóstico; essas colunas de diagnóstico são ignoradas no novo carregamento.

Em caso de falha temporária no processamento, use Tentar novamente quando essa opção estiver disponível. Repetir a mesma tarefa não corrige dados de produto inválidos. Se a interface indicar que algumas linhas precisam ser revisadas pelo suporte, use Contact support; essas linhas não são processadas novamente de forma automática.

Atualizar produtos existentes#

Para atualizar produtos, use o mesmo modelo de categoria e mantenha o SKU existente de cada produto. Preencha todos os campos obrigatórios para cada linha incluída, altere os valores que deseja atualizar e carregue o arquivo novamente.

O mesmo SKU na mesma loja atualiza o produto existente. Um SKU que ainda não existe cria um novo produto. Alterar um SKU na planilha não renomeia o produto original.
Você pode carregar apenas as linhas de produto que deseja atualizar. Produtos ausentes no arquivo não são excluídos, desabilitados ou despublicados.
Esta não é uma atualização parcial de campos: os campos obrigatórios ainda precisam de valores. Não suponha que uma célula opcional em branco preserve o valor anterior. Em particular, status em branco usa active como padrão e unidades de dimensão ausentes usam in como padrão.
Mantenha sua própria pasta de trabalho concluída para atualizações futuras. O download do modelo não inclui seus dados de produto atuais.

Após o término da tarefa, verifique os produtos afetados no Catálogo. A importação bem-sucedida por si só não confirma a visibilidade na vitrine; verifique se os produtos estão prontos para visualização e consulte a lista de verificação de lançamento do SDK.

Automatize as importações#

Para sincronização recorrente do lado do servidor, use a Product Import API. Seus campos de solicitação, limites e comportamento de atualização parcial são documentados separadamente deste fluxo de trabalho com planilha.