Importação e Exportação CSV
Guia completo para cadastrar e atualizar produtos em massa usando arquivos CSV no PAP Afiliados Pro.
Visão Geral
A importação CSV permite cadastrar dezenas (ou centenas) de produtos de uma vez, sem precisar preencher cada um manualmente. O plugin detecta automaticamente o encoding e o delimitador do arquivo, valida os dados antes de importar e processa tudo em lotes para não sobrecarregar o servidor.
Acesse em PAP Afiliados Pro > Importar/Exportar CSV.
Formato do Arquivo
O CSV deve conter 8 colunas, nesta ordem:
| # | Coluna | Obrigatória | Descrição |
|---|---|---|---|
| 1 | ID | Não | Vazio = cria novo produto. Preenchido = atualiza produto existente |
| 2 | Título | Sim | Nome do produto |
| 3 | Descrição | Não | Texto descritivo do produto |
| 4 | Preço | Não | Valor numérico (ex: 99.90). Aceita formato com R$ e vírgulas |
| 5 | Link de Afiliado | Sim | URL completa com seu código de afiliado |
| 6 | URL da Imagem | Não | Link direto para a imagem do produto |
| 7 | Categoria | Não | Nome da categoria. Suporta hierarquia com “Pai > Filho” |
| 8 | Tags | Não | Tags separadas por vírgula (ex: “oferta, destaque, black-friday”) |
O plugin inclui um arquivo CSV de exemplo com 3 produtos fictícios para servir de modelo. Você pode baixá-lo diretamente na página de importação clicando em Baixar CSV de exemplo.
Como Importar
O processo acontece em 3 etapas:
1. Upload
Arraste o arquivo CSV para a área de upload (drag & drop) ou clique nela para selecionar o arquivo. Limites: formato .csv, tamanho máximo de 5 MB, até 1.000 linhas.
2. Validação e Preview
Antes de importar, o plugin valida o arquivo e exibe uma tabela de preview com as primeiras linhas. Nessa etapa ele:
- Detecta automaticamente o encoding (UTF-8, Windows-1252, ISO-8859-1) e converte para UTF-8
- Detecta automaticamente o delimitador (vírgula ou ponto-e-vírgula)
- Remove BOM se presente
- Verifica se as 8 colunas estão no header
- Marca erros em vermelho (bloqueiam a importação) e warnings em amarelo (permitem continuar)
Se o preview estiver correto, clique em Importar para prosseguir.
3. Importação com Progress Bar
A importação processa 20 linhas por vez (batch processing), exibindo uma barra de progresso com porcentagem. Ao final, um relatório mostra:
- Produtos criados (novos)
- Produtos atualizados (por ID)
- Linhas ignoradas (erros)
- Categorias criadas automaticamente
- Tags criadas automaticamente
Criar vs. Atualizar Produtos
A coluna ID controla o comportamento:
ID vazio → O plugin cria um novo produto como rascunho. Você pode publicar depois manualmente ou em massa pela listagem de produtos.
ID preenchido → O plugin localiza o produto com aquele ID e atualiza os campos informados. Útil para atualizar preços, links ou descrições em lote.
Na prática, o fluxo mais comum é: importar produtos novos (sem ID), depois exportar o CSV (que agora inclui os IDs atribuídos), e usar esse CSV atualizado para futuras atualizações.
Categorias e Tags
Categorias são criadas automaticamente se não existirem. O plugin suporta hierarquia usando o separador ” > ” (espaço-maior que-espaço):
Notebooks→ Cria a categoria “Notebooks”Eletrônicos > Notebooks→ Cria “Eletrônicos” como pai e “Notebooks” como filhaEletrônicos > Notebooks > Gamer→ Suporta múltiplos níveis
Tags também são criadas automaticamente. Separe múltiplas tags por vírgula no mesmo campo:
oferta, destaque, black-friday→ Cria e atribui as 3 tags
Marketplace Automático
Você não precisa informar o marketplace no CSV. O plugin detecta automaticamente a partir do link de afiliado:
- Links com
amazon.com.br→ Amazon - Links com
mercadolivre.com.brouproduto.mercadolivre→ Mercado Livre - Links com
shopee.com.br→ Shopee - Links com
aliexpress.com→ AliExpress - Links com
magazineluiza.com.broumagalu.com→ Magazine Luiza - Outros domínios → Marcado como “Outro”
O marketplace detectado é salvo automaticamente e exibido como badge no card do produto.
Exportação
A exportação gera um arquivo CSV com todos os seus produtos cadastrados — publicados, rascunhos, pendentes e privados. O formato é idêntico ao da importação (mesmas 8 colunas), com os IDs preenchidos.
Para exportar, clique em Exportar Produtos na mesma página de importação.
O arquivo exportado usa encoding UTF-8 com BOM e ponto-e-vírgula como delimitador — compatível com Excel em português. O nome do arquivo segue o padrão papafpro-produtos-export-YYYY-MM-DD.csv.
Usos comuns da exportação: backup dos produtos, atualização de preços em planilha e reimportação, ou migração entre sites WordPress.
Dicas Práticas
Use o CSV de exemplo como template. Baixe o arquivo de exemplo, substitua os dados pelos seus produtos e importe. É o caminho mais rápido para começar.
Excel e ponto-e-vírgula. Se você usa Excel em português, o delimitador padrão é ponto-e-vírgula (não vírgula). O plugin detecta ambos automaticamente, então não se preocupe — funciona nos dois casos.
Atualize preços em lote. Exporte seus produtos, abra no Excel, altere os preços, salve e reimporte. Como o CSV exportado já vem com os IDs, o plugin atualiza os produtos existentes em vez de criar duplicatas.
Imagens externas. A coluna “URL da Imagem” aceita qualquer URL pública de imagem. O plugin faz o download e armazena localmente na biblioteca de mídia do WordPress. Se a URL não for acessível, o produto é criado sem imagem (usa o placeholder padrão).
Produtos sem link vão para rascunho. Se a coluna “Link de Afiliado” estiver vazia, o produto é criado como rascunho — o mesmo comportamento do cadastro manual. Sem link, não faz sentido exibir no site.
Limites
- Tamanho máximo do arquivo: 5 MB
- Máximo de linhas: 1.000 por importação
- Processamento em batches de 20 linhas
- Encoding suportado: UTF-8, Windows-1252, ISO-8859-1, ASCII
Para volumes maiores, divida o arquivo em partes e importe separadamente.