Este guia explica como usar essas funções na área do vendedor e com o que o sistema compara as regras, em linguagem simples. Não é necessário conhecer termos técnicos de sistema.
Onde encontrar cada função
Função: Importar por planilha
Onde: Menu de produtos/serviços do vendedor → fluxo de importação (envio do arquivo, mapeamento de colunas e confirmação).
Função: Edição em massa e mesclagem
Onde: Na listagem de produtos/serviços, ao marcar itens na grade (modo seleção).
Computador (tela grande): a importação por planilha, a edição em massa e a mesclagem em lote só aparecem em telas largas (por exemplo notebook ou monitor). Em celular, use o computador para essas tarefas.
1. Importação por planilha
Para que serve
Criar ou atualizar vários produtos/serviços de uma vez a partir de um arquivo CSV ou Excel (XLS/XLSX) com cabeçalho na primeira linha.
Passo a passo (visão geral)
- Enviar o arquivo — escolha o arquivo e avance.
- Mapear colunas — diga qual coluna do arquivo corresponde a cada campo (nome e preço são obrigatórios; os demais são opcionais conforme seu modelo).
- Confirmar e importar — o sistema verifica possíveis duplicadas na sua conta e, se houver, pede que você escolha como proceder antes de importar.
Se as fotos do marketplace forem bloqueadas no servidor, use a aba Pacote (planilha + fotos) — veja importacao-por-pacote.md.
O que conta como “duplicada” na importação
Uma linha da planilha é considerada duplicada de algo que você já tem cadastrado quando, ao mesmo tempo:
- o nome (título do produto/serviço) for exatamente igual ao de um item ativo seu, e
- o SKU for igual ou o código interno for igual ao desse mesmo cadastro.
Importante: para essa verificação, a linha precisa ter nome e pelo menos um dos dois: SKU ou código interno mapeados e preenchidos. Sem isso, o sistema não usa esse critério de duplicada para aquela linha.
Se não houver duplicada
Todas as linhas válidas (com nome e preço corretos) serão tratadas como novos cadastros.
Se houver duplicada
Você deve escolher uma das opções antes de clicar em importar:
- Atualizar cadastros existentes — onde a planilha bater com nome + (SKU ou código interno), o sistema atualiza o item já existente. As outras linhas (sem duplicada) continuam sendo criadas como novos.
- Criar novos em todas as linhas — mesmo onde haveria duplicada, será criado outro cadastro. Pode ficar mais de um produto com nome parecido; depois você pode ajustar ou mesclar na gestão de produtos/serviços (não na importação).
Vários cadastros “iguais” na conta (mesmo nome + mesmo SKU ou código)
Se existir mais de um produto ativo com o mesmo nome e o mesmo SKU (ou o mesmo código interno), o sistema usa um critério de vínculos (por exemplo anúncios, kits, coleções) para decidir qual cadastro recebe a atualização — o que tiver mais ligações com o negócio tende a prevalecer. Isso vale na prévia e na importação em modo “atualizar”.
A mesclagem automática de cadastros não acontece na importação. Mesclar é um passo separado, na listagem de produtos/serviços (veja a secção 3).
Depois que você clica em importar
- O processamento costuma ser em segundo plano: você pode receber uma mensagem de que a importação está em andamento e será avisado quando terminar (notificação na conta).
- Se houver falhas em parte das linhas, o resumo pode incluir envio de e-mail com detalhes do que não entrou.
Limites e boas práticas
- Há um limite máximo de linhas válidas por arquivo (nome + preço preenchidos); hoje esse limite é 500 linhas por importação.
- Use arquivo em UTF-8. Evite vírgulas soltas dentro de células de nome no CSV, se o separador for vírgula.
- Baixe os modelos oferecidos na tela de importação quando quiser alinhar colunas (tipo de transação, unidade de preço, etc.).
2. Edição em massa
Para que serve
Alterar o mesmo tipo de informação em vários produtos/serviços de uma vez (por exemplo subir o preço de todos os selecionados), sem abrir um por um.
Como usar
- Na listagem, marque os itens desejados (modo seleção).
- Abra o painel de edição em massa.
- Marque apenas os campos que você quer alterar (preço, desconto, estoque, quantidades mínima/máxima, “ilimitado”, dias de produção, envio físico, itens por caixa, peso, etc.).
- Preencha os valores só para o que marcou.
- Confira a prévia na tabela e clique para aplicar nos selecionados.
Lógica (como o sistema se comporta)
- Só entram na alteração os campos em que você explicitamente marcou a opção de editar; o restante do cadastro de cada item não é apagado por essa tela.
- Alguns campos não se aplicam a todos os tipos de produto/serviço (por exemplo regras de quantidade mínima/máxima ou estoque em certos tipos). A interface pode avisar quando um item selecionado não é compatível com o que você marcou — nesse ca