# Importação, edição em massa e mesclagem

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/anuncios/importacao-edicao-em-massa-e-mesclagem

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.

Cobre **produtos/serviços** (importação por planilha, edição em massa e mesclagem) e **anúncios** (edição em massa de status e forma de pagamento).

---

## Onde encontrar cada função

| Função | Onde |
|--------|------|
| **Importar por planilha** | Menu de produtos/serviços do vendedor → fluxo de importação (envio do arquivo, mapeamento de colunas e confirmação). |
| **Edição em massa**, **mesclagem**, **criar kit** e **criar anúncio** (produtos/serviços) | Na listagem de produtos/serviços, ao marcar itens na **grade** ou na vista em **cards** (modo seleção). |
| **Edição em massa** (anúncios) | **Meus Anúncios** → ative a visualização **Grade** → marque os anúncios desejados → **Edição em Massa**. |

**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. Isso vale também para a **edição em massa de anúncios**. **Criar kit** e **criar anúncio** a partir da seleção usam a mesma barra — em tela estreita, prefira cards ou um computador.

---

## 1. Edição em massa de produtos/serviços

### 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 de produtos/serviços, marque os itens desejados (modo seleção na grade).
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 caso ajuste a seleção ou desmarque aquele tipo de alteração.
- **Preço com desconto:** você pode indicar desconto em valor fixo ou em percentual, ou marcar que não há desconto, conforme as opções exibidas.

---

## 2. Edição em massa de anúncios

### Para que serve

Alterar **status** (ativar ou desativar) e/ou **forma de pagamento** em **vários anúncios** de uma vez, sem abrir a edição de cada um.

Útil quando você quer publicar ou pausar vários anúncios juntos, ou padronizar cartão, Pix e boleto (e parcelas) em um grupo de anúncios.

### Como usar

1. Acesse **Meus Anúncios**.
2. Clique no botão para alternar para a visualização **Grade** (ícone de grade na barra de abas).
3. Marque os anúncios desejados com a caixa de seleção na primeira coluna (ou use **selecionar todos** no cabeçalho da tabela).
4. Clique em **Edição em Massa (N selecionados)**.
5. Marque **apenas** o que deseja alterar:
   - **Alterar status do anúncio** — escolha **Ativar** ou **Desativar**.
   - **Alterar forma de pagamento** — marque uma ou mais opções: **Cartão de crédito**, **Pix**, **Boleto**.
6. Se marcou **cartão**, informe **máximo de parcelas** e, se aplicável, **juros acima de 2 parcelas** e o **percentual de juros**.
7. Clique em **Aplicar alterações**.

### Campos disponíveis

| Campo | O que faz |
|-------|-----------|
| **Status** | Define se o anúncio fica **ativo** (publicado no painel) ou **inativo**. |
| **Cartão de crédito** | Aceita ou remove pagamento por cartão no checkout do anúncio. |
| **Pix** | Aceita ou remove Pix. |
| **Boleto** | Aceita ou remove boleto. |
| **Máximo de parcelas** | Quantidade máxima de parcelas no cartão (de 1 a 12). |
| **Juros** | Opção de aplicar juros em parcelas acima de 2; exige informar o percentual quando ativada. |

É obrigatório marcar **pelo menos uma** forma de pagamento quando você escolhe alterar pagamentos.

### Lógica (como o sistema se comporta)

- A grade envia **uma única requisição** ao servidor (`POST /api/ads/bulk-update`), que processa todos os anúncios selecionados de forma **síncrona** (a resposta só volta quando terminar).
- Ao concluir, o painel recebe um aviso via **WebSocket** (`ads:bulk-update:complete`) e a listagem é atualizada automaticamente.
- Só entram na alteração os blocos que você **marcou** (status e/ou pagamento). O restante do cadastro de cada anúncio **não é alterado** por essa tela.
- Ao **ativar** anúncios, o sistema respeita o **limite do seu plano** (quantidade de anúncios ativos e aprovados permitidos). Se o limite for atingido, a ativação pode falhar e você verá um aviso — nesse caso revise sua assinatura ou desative outros anúncios antes.
- Anúncio **ativo** ainda precisa passar pela **moderação** para ficar visível publicamente; ativar em massa não substitui a aprovação automática ou manual.
- Ao alterar **forma de pagamento**, a nova configuração vale para **todos os anúncios selecionados** com as mesmas opções e parcelas que você definiu no painel.
- Para ativar ou desativar **um** anúncio sem usar a grade, continue podendo clicar no **círculo verde/vermelho** na coluna Estado ou no card na visualização em lista.

### O que esta edição em massa **não** altera

- Título, descrição, imagens, categoria, tags ou opções (produtos/serviços e kits) do anúncio.
- Preço, estoque ou frete dos itens — isso é feito na edição em massa de **produtos/serviços** ou na edição individual de cada anúncio.
- Lixeira: mover para lixeira ou restaurar continua sendo ação individual por anúncio.

### Dicas

- Use os **filtros e abas** (Ativos, Inativos, Aguardando aprovação, etc.) antes de selecionar, para trabalhar só no grupo certo.
- Se precisar conferir inconsistências antes de publicar, use o filtro **Apenas anúncios com problemas** na grade (regras alinhadas à aprovação automática).
- Para configurar **gateways** (PagBank, Mercado Pago) que efetivamente processam o pagamento, veja [Configurando pagamentos](../recebimentos/configurando-pagamentos.md).

---

## 3. Mesclagem de produtos/serviços

A mesclagem em lote (unir cadastros duplicados) está documentada em [Importação — mesclagem](./importacao-mesclagem.md).

---

## 4. Criar kit ou anúncio a partir da seleção

Na mesma barra de seleção da listagem de produtos/serviços:

| Botão | Resultado |
|-------|-----------|
| **Criar kit** | Abre a criação de kit com os itens selecionados (≥2). Detalhes em [Kits](./kits.md#criar-kit-a-partir-da-seleção-na-listagem). |
| **Criar anúncio** | Abre um anúncio com várias opções já marcadas (≥2), com sugestão de IA conforme o plano. Detalhes em [Anúncios](./anuncios.md#criar-anúncio-a-partir-de-vários-produtosserviços). |

Use **kit** quando os itens formam um **pacote vendido junto**. Use **criar anúncio** quando cada item deve ser uma **opção à escolha** do comprador no mesmo anúncio.

---

## Resumo rápido

| Situação | O que fazer |
|----------|-------------|
| Subir muitos produtos/serviços de uma vez | Importação por planilha (computador). |
| Ajustar preço/estoque/etc. em vários produtos/serviços | Edição em massa na listagem em grade. |
| Montar um kit com itens já cadastrados | Marcar ≥2 → **Criar kit**. |
| Anunciar várias opções no mesmo anúncio | Marcar ≥2 → **Criar anúncio**. |
| Ativar ou desativar vários anúncios | Meus Anúncios → Grade → edição em massa → status. |
| Padronizar Pix/cartão/boleto em vários anúncios | Meus Anúncios → Grade → edição em massa → forma de pagamento. |
| Unificar cadastros duplicados | Mesclagem na listagem de produtos/serviços. |

Se algo na tela não aparecer, verifique se está usando **tela grande** e se a loja/conta tem permissão para gerir produtos/serviços ou anúncios nessa área.
