# Importação por planilha de produtos/serviços

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/anuncios/importacao-por-planilha-de-produtos-servicos

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)

1. **Enviar o arquivo** — escolha o arquivo e avance.
2. **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).
3. **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](./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

1. Na listagem, marque os itens desejados (modo seleção).
2. Abra o painel de **edição em massa**.
3. **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.).
4. Preencha os **valores** só para o que marcou.
5. 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
