Importar produtos para o OpenCart a partir de CSV sem duplicatas

Planeje identificadores de produtos estáveis, mapeie colunas CSV e teste importações repetidas antes de atualizar seu catálogo OpenCart com o Import Export PRO.

Uma importação de produto só é útil se executá-la duas vezes lhe der o mesmo catálogo, em vez de duas vezes mais produtos. Antes de carregar um CSV no OpenCart, defina como uma linha identifica um produto e quais campos aquele arquivo pode alterar. Essa decisão é mais importante do que o tamanho da planilha.

Este guia cobre um fluxo de trabalho de atualização de produtos repetível usando Import Export PRO. Seu mapeamento de colunas e perfis de importação ajudam a adaptar arquivos de fornecedores à sua loja. Os campos e operações exatos disponíveis dependem da sua versão instalada e perfil; exporte um exemplo dessa instalação antes de construir seu arquivo.

Escolha uma chave de correspondência estável

Não use um nome de produto como identificador. Nomes mudam, traduções diferem e dois produtos podem compartilhar o mesmo título. Escolha uma chave que permaneça estável, como um identificador de loja existente ou um SKU de fornecedor único mapeado para seu próprio catálogo. Confirme quais identificadores seu perfil de importação realmente suporta.

Um SKU não é automaticamente único só porque uma coluna é chamada SKU. Verifique o arquivo fonte e a loja existente em busca de duplicatas. Se dois fornecedores vendem um item chamado 1001, mantenha um mapeamento explícito ou use identificadores específicos do fornecedor que seu processo possa resolver de forma consistente.

Linha ilustrativaChave de correspondênciaResultado esperado
Camisa azul existenteSHIRT-BLUEAtualizar o produto existente
Mesma camisa com um novo títuloSHIRT-BLUEMantenha a identidade do produto
Nova camisa vermelhaSHIRT-REDCriar apenas se o perfil permitir novos produtos

Construa um pequeno arquivo antes de um grande

Exportar alguns produtos representativos primeiro. Incluir um produto simples, um com opções e um com múltiplas categorias. Mantenha a exportação como referência para nomes de campos e formatos suportados. Não trate o exemplo abaixo como um modelo de extensão pronto; mapeie esses cabeçalhos ilustrativos para os campos no seu próprio perfil.

supplier_sku,name,price,quantity
SHIRT-BLUE,Blue cotton shirt,24.90,18
SHIRT-RED,Red cotton shirt,24.90,0

Salve o arquivo com a codificação e delimitador selecionados no importador. Inspecione-o em um editor de texto simples, bem como em uma planilha. Aplicativos de planilha podem remover zeros à esquerda, reformatar identificadores longos e interpretar códigos de produtos como datas. A citação também é importante quando uma descrição contém o delimitador.

Separe a criação de produtos de atualizações rotineiras

Use perfis diferentes para a criação inicial de produtos e atualizações diárias de estoque. Um arquivo de estoque não deve substituir inesperadamente descrições cuidadosamente editadas, atribuições de categoria ou URLs SEO. Liste os campos pertencentes a cada processo: por exemplo, o fornecedor controla a disponibilidade, enquanto a equipe de merchandising controla descrições e imagens.

Decida como o perfil lida com células em branco. Um valor vazio pode significar "limpar este campo", "deixar inalterado" ou "entrada inválida", dependendo do campo e da configuração. Teste esse comportamento explicitamente em vez de assumir que cada célula vazia será ignorada. Uma linha de produto ausente também precisa de uma política separada; a ausência de um arquivo não é prova de que um produto foi descontinuado.

Executar um teste de repetibilidade em staging

  1. Registre a contagem de produtos e exporte os produtos-alvo antes de importar.
  2. Importar uma pequena amostra contendo um item existente, um novo item, estoque zero e uma alteração de título.
  3. Verifique identificadores, preços, estoque, categorias, imagens e opções tanto na administração quanto na loja.
  4. Importar o arquivo idêntico novamente. Itens existentes devem manter sua identidade e a contagem de produtos não deve aumentar inesperadamente.
  5. Mudar um valor e confirmar que apenas o produto e campos pretendidos mudam.

Além disso, tente uma chave duplicada, um preço inválido e um valor obrigatório ausente. Um processo seguro deve produzir um resultado claro e revisável. Mantenha o relatório e sua exportação original até que os resultados tenham sido reconciliados. Não use um recurso de recuperação automática como substituto para um procedimento de backup e restauração testado.

Verifique a loja, não apenas o relatório de importação

Um upload bem-sucedido não prova que os compradores veem as informações corretas. Abra vários produtos, escolha suas opções, adicione-os a um carrinho de teste e compare os totais exibidos com os valores pretendidos. Verifique cada loja e idioma afetados pelo perfil.

Após importações que alteram preços ou estoque, revise também quaisquer feeds de publicidade programados. Um banco de dados de loja limpo ainda pode ser seguido por um catálogo externo desatualizado. Nossa guia de identificador de feed de produtos explica as verificações de identidade, enquanto o checklist de sincronização de fornecedores cobre atualizações repetidas.

Quando você deve automatizar a importação?

Automatizar após a amostra e os testes de repetibilidade serem aprovados e alguém assumir o processo de falha. Mantenha um perfil nomeado, uma fonte de arquivo conhecida e um registro do que mudou. Se o formato da fonte mudar, pare e revalide antes da próxima execução de produção. Uma importação automatizada deve tornar um processo comprovado mais fácil de repetir, em vez de fazer um processo incerto ser executado com mais frequência.