# Mesclagem de produtos/serviços

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/anuncios/mesclagem-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.

### 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.).

---

## 3. Mesclagem de produtos/serviços

### Para que serve

Quando você tem **mais de um cadastro** que na prática representam o **mesmo** produto ou serviço (mesmo SKU, mesmo código, ou mesma combinação permitida pelas regras), a mesclagem **une** esses cadastros em **um só**: um permanece ativo e os outros são desativados, com anúncios, kits e demais vínculos **reorganizados** para o que ficou.

### Como usar

1. Na listagem, marque **dois ou mais** itens para mesclar.
2. Confirme a ação quando o sistema pedir.
3. A operação é feita **na hora** no servidor; ao terminar, você recebe **notificação na conta** e um **e-mail com resumo** (grupos mesclados, o que ficou como “mantido”, itens que não entraram em nenhum grupo, etc.).

### Como o sistema monta os “grupos”

Nem sempre todos os selecionados podem virar **um único** cadastro. O sistema **liga dois itens** se, **em par**, eles respeitam as **regras de mesclagem** (resumo em linguagem corrente):

1. **Todos sem código interno** e com o **mesmo SKU** (e pelo menos um SKU preenchido).
2. **Todos sem SKU** e com o **mesmo código interno** (e pelo menos um código preenchido).
3. **Sem SKU e sem código** em todos e com o **mesmo nome**.
4. **Mesmo SKU preenchido e/ou mesmo código interno preenchido**, com **nomes diferentes** entre os itens (caso previsto para alinhar cadastros duplicados com nomes distintos).

Depois, o sistema agrupa por **“cadeias de ligação”**: se A combina com D, eles ficam no mesmo grupo; se B combina com C em outro par, B e C formam **outro** grupo — **desde que** não exista uma sequência de ligações juntando tudo. Exemplo clássico: A liga com D, e C liga com B, mas A não liga com B nem com C → **duas mesclagens**: uma para A+D e outra para C+B.

### Quem “fica” como cadastro principal

Entre os itens de **cada grupo**, permanece o que o sistema considera ter **mais vínculos** com o negócio (anúncios, kits, coleções, calendários, frete, imagens, etc.). Em empate, critérios internos adicionais podem desempatar.

### O que não faz parte da mesclagem na importação

Na **importação por planilha** não há mesclagem automática de vários cadastros num só. Para unificar cadastros duplicados, use a **mesclagem** na listagem, **depois** de revisar nomes, SKU e códigos.
