1. Documentation /
  2. Como exportar e importar CSV de produtos

Como exportar e importar CSV de produtos

O WooCommerce tem um exportador e importador CSV de produtos, a partir da versão 3.1x.

Importe, exporte ou atualize centenas ou milhares de produtos na sua loja WooCommerce com um único CSV. Esta ferramenta suporta todos os tipos de produtos, incluindo variações.

  • Os proprietários de lojas iniciantes começam mais rapidamente exportando e importando produtos durante a instalação.
  • Os proprietários de lojas existentes podem atualizar dezenas ou centenas de produtos com novas informações ou colocá-los à venda ou sincronizar vários sites.

Nota: Se você estiver usando a extensão paga do Product CSV Import Suite (Suite para Importar CSV de produto), consulte a documentação em: Product CSV Import Suite.

Criar seu CSV

↑ Back to top

Para importar novos produtos ou atualizar produtos existentes, você precisa de um CSV contendo as informações do produto. Você pode:

Se você estiver usando a ferramenta Exportador e importador de CSV de produtos do WooCommerce para exportar um CSV, o arquivo já segue o esquema e está pronto para ser usado. Se você estiver usando o arquivo CSV em branco e formatado, este arquivo também segue o esquema; somente certifique-se de inserir as informações conforme as instruções no Esquema de importação do CSV de produtos (disponível somente em inglês).

Diretrizes gerais

↑ Back to top
  • Os CSVs devem estar no formato UTF-8.
  • As datas devem ser definidas para o fuso horário local da loja.
  • Use 1 ou 0 no seu CSV, se estiver importando um valor Booleano (verdadeiro ou falso).
  • Vários valores em um campo são separados por vírgulas.
  • Adicionar texto e valores entre aspas permite que você insira vírgulas.
  • Insira o prefixo do ID com id: se estiver relacionado a um ID do produto existente. Nenhum prefixo é necessário se estiver relacionado com uma REF. Por exemplo: id:100, REF101
  • Meta personalizada é suportado/importado, mas somente texto sem formatação – sem suporte para dados serializados ou JSON.
  • A hierarquia de termos de taxonomia é simbolizada com >, os termos são separados por vírgulas.
  • Os produtos de rascunhos não são exportados, somente produtos publicados e publicados como privado.

Imagens

↑ Back to top
  • As imagens precisam ser pré-enviadas ou disponíveis on-line para serem importadas para a sua loja.
  • URLs externos são suportados e importados para a Biblioteca de mídia, se usados.
  • Você pode definir o nome do arquivo se a imagem já existir na Biblioteca de mídia.

Importar

↑ Back to top

Como adicionar novos produtos

↑ Back to top

Os proprietários de lojas existentes e iniciantes usando o WooCommerce podem usar o CSV para adicionar novos produtos com um único envio.

1/ Vá para: WooCommerce > Produtos.

2/ Selecione Importar na parte superior. A tela Fazer upload de arquivo CSV é exibida.

3/ Selecione Escolher arquivo e o CSV que você deseja usar.

Delimitador do CSV (opção avançada): Geralmente os elementos CSV são separados por vírgula. Se você estiver usando um delimitador diferente no seu arquivo, poderá configurá-lo aqui.

4/ Continuar.

A tela Mapeamento de colunas é exibida e o WooCommerce tenta automaticamente localizar ou “mapear” o Nome da coluna do seu CSV para o Campos.

5/ Use os menus suspensos no lado direito para ajustar os campos ou indicar ‘Não importar.’

*Todas as colunas não reconhecidas não serão importadas por padrão.

6/ Selecione Executar o importador.

7/ Aguarde até que o importador seja concluído. Não atualize ou toque no navegador enquanto estiver em andamento.

Atualizar produtos existentes

↑ Back to top

Os proprietários das lojas podem usar a ferramenta Importador de CSV para atualizar os produtos existentes com novas informações, por exemplo, Adicionar uma marca, alterar uma classe de taxa, atualizar em massa, para um evento ou promoção especial, etc.

1/ Crie um arquivo CSV conforme indicado em Criar seu CSV, usando os IDs e/ou REFs dos produtos que você deseja atualizar.

O importador usa o ID e/ou REF para localizar e atualizar automaticamente as informações inseridas em cada linha.

2/ Vá para: WooCommerce > Produtos.

3/ Selecione Importar na parte superior. A tela Fazer upload de arquivo CSV é exibida.

4/ Selecione Escolher arquivo e o CSV que você deseja usar.

5/ Selecione a caixa de seleção para Atualizar produtos existentes.

6/ Continuar.

A tela Mapeamento de colunas é exibida e o WooCommerce tenta automaticamente localizar ou “mapear” o Nome da coluna do seu CSV para os Campos.

7/ Use os menus suspensos no lado direito para ajustar os campos ou indicar ‘Não importar.’

*Todas as colunas não reconhecidas não serão importadas por padrão.

8/ Selecione Executar o importador.

9/ Aguarde até que o importador seja concluído. Não atualize ou toque no navegador enquanto estiver em andamento.

Exportar

↑ Back to top

Os proprietários das lojas que desejam exportar seu catálogo atual de produtos por algum motivo, podem gerar um CSV usando o Exportador/Importador de produto.

1/ Vá para: WooCommerce > Produtos.

2/ Selecione Exportar na parte superior. A tela Exportar produtos é exibida

3/ Selecione para Exportar todas as colunas . Ou selecione quais colunas exportar usando o menu suspenso.

4/ Selecione para Exportar todos os produtos . Ou selecione quais tipos de produtos exportar usando o menu suspenso.

5/ Selecione para Exportar todas as categorias. Ou selecione quais categorias exportar usando o menu suspenso.

6/ Selecione a caixa para Exportar metadados personalizados, se você precisar destas informações.

Os metadados dos seus produtos normalmente são de outros plugins. As colunas de metadados são exportadas seguindo o padrão de prefixo meta: detalhado acima na seção de mapeamento do importador. Por padrão, nenhum metadado adicional é exportado.

7/ Selecione Gerar CSV. Aguarde a exportação ser concluída.

8/ Saia do exportador.

Perguntas frequentes

↑ Back to top

É possível adicionar colunas de importação personalizadas?

↑ Back to top

Sim. Consulte o repositório do WooCommerce no GitHub para visualizar o código personalizado em Adicionando colunas de importação personalizadas (disponível somente em inglês). Esteja ciente de que são informações a nível de desenvolvedor para as quais não fornecemos assistência de acordo com a nossa Política de suporte.

É possível adicionar colunas de exportação personalizadas?

↑ Back to top

Sim. Consulte o repositório WooCommerce no GitHub para visualizar o código personalizado em Adicionando colunas de exportação personalizadas (disponível somente em inglês). Esteja ciente de que estas são informações a nível de desenvolvedor para as quais não fornecemos assistência de acordo com a nossa Política de suporte.

Por que todos os meus produtos não são exportados?

↑ Back to top

Antes do WooCommerce 3.6.5, somente os produtos com status de ‘publicado’ ou ‘privado’ eram exportados, e aqueles com status ‘rascunho’ não eram exportados. Se você desejar alterar isto, existe um filtro que pode ser usado, mas isso requer codificação personalizada, com a qual não podemos fornecer assistência.

Por que todos os meus produtos não são importados?

↑ Back to top

Antes do WooCommerce 3.6.5, somente os produtos com status de ‘publicado ou ‘privado’ eram importados, e aqueles com status ‘rascunho’ não eram importados. A partir do WooCommerce 3.7, é possível importar CSV de produtos com valores verdadeiros/falsos para o campo publicado, assim como os valores originais 0 (privado), -1 (rascunho) e 1 (publicado).

Erro de permissão ao importar?

↑ Back to top

Você está vendo o seguinte erro de permissão ao importar o seu arquivo CSV?
Tipo de arquivo inválido. O importador suporta apenas os formatos CSV e TXT.

Quando um arquivo de importação contém HTML, o tipo de arquivo pode ser detectado incorretamente pelo WordPress em alguns servidores. Uma solução alternativa é adicionar a seguinte linha ao seu arquivo wp-config.php:
define( 'ALLOW_UNFILTERED_UPLOADS', true );

Por motivos de segurança, você somente pode habilitar isto temporariamente no momento da importação para, em seguida, removê-lo novamente do arquivo de configuração.

Como aumentar o tamanho máximo de importação de CSV?

↑ Back to top

O valor do tamanho máximo é definido a nível de servidor. Para aumentar o tamanho máximo do arquivo, sugerimos entrar em contato com a sua empresa de hospedagem. Como alternativa, você pode dividir o CSV em várias partes para fazer o upload separadamente.