# Itens adicionais

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/anuncios/itens-adicionais

## O que são itens adicionais?

Itens adicionais são produtos ou serviços que **só podem ser comprados junto com um produto principal** no carrinho. Eles aparecem como opções extras na página do anúncio, quando o comprador escolhe uma variante ou kit principal.

Exemplos: acompanhamento para um prato, decoração extra para um pacote de festa, serviço adicional (ex.: montagem à parte) para um evento.

## Quando usar itens adicionais?

- Quando você quer vender **extras** que dependem de um item principal (ex.: produto + item adicional).
- Quando o item **não faz sentido sozinho** no carrinho (ex.: “adicional por pessoa” só junto com o pacote).
- Quando quer **limitar** com quais produtos ou kits esse item pode ser adicionado (lista de permitidos).

## Regras principais

### 1. Só entram no carrinho com produto principal

- O comprador **não** consegue adicionar um item adicional ao carrinho se não houver nenhum produto principal (variante ou kit que não seja adicional).
- Se o carrinho tiver só itens adicionais, o sistema exige que um produto principal seja adicionado primeiro.

### 2. Lista de permitidos e anúncios (como nas coleções)

- Em **“Pode ser adicionado junto com”** você seleciona os produtos/serviços ou kits com os quais este item pode ser vendido. É necessário selecionar **pelo menos uma** opção.
- **Os anúncios em que o item aparecerá são definidos automaticamente**: o item passa a figurar em todos os anúncios que contêm pelo menos uma das variantes ou kits selecionados (mesma lógica das coleções: variantes/kits → anúncios derivados).
- No carrinho: o adicional **só** poderá ser adicionado quando um dos itens permitidos (variante ou kit) estiver no carrinho.

### 3. Sem calendário e sem frete

- Itens adicionais **não** usam calendário (datas/períodos) nem configuração de frete.
- Eles herdam o contexto do pedido do produto principal (evento, entrega etc.).

### 4. Espelhar quantidade do item principal (opcional)

- Na criação/edição do adicional, marque **Espelhar quantidade do item principal** quando a quantidade do extra deve ser **sempre igual** à do principal (ex.: 1 adicional por unidade do principal).
- Com espelhamento ativo:
  - o comprador **não** escolhe quantidade do adicional na vitrine;
  - no **carrinho**, ao mudar a quantidade do principal, a quantidade do adicional **atualiza na hora** (totais incluídos);
  - a unidade de preço do adicional precisa ser **compatível** com a do principal (o sistema remove vínculos incompatíveis).
- Sem espelhamento, você define mínimo/máximo (ou ilimitado) e o comprador escolhe a quantidade ao adicionar.

### 5. Apenas uma imagem (capa), da galeria da loja

- Cada item adicional tem **apenas uma imagem de capa** (não há galeria de várias imagens no item).
- A imagem de capa deve ser **escolhida da galeria da loja**, como nos demais produtos/serviços.
- Na importação por planilha/CSV, use a coluna **“Imagem (URL)”** para a capa; a coluna **“Item adicional”** deve ser **Sim** para marcar o item como adicional.

### 6. Tipo de transação e precificação

- Você escolhe o **tipo de transação** (Venda, Locação ou Serviço) e a **unidade de preço** (por unidade, por pessoa, por dia, etc.), como em qualquer produto/serviço.
- As opções de precificação respeitam o tipo (ex.: “por dia” só para Locação/Serviço) mas não será calculado como no item principal. O preço será multiplicado pela quantidade.

## Como criar um item adicional

1. Acesse **Produtos/Serviços** e use o fluxo **“Criar item adicional”** (ou edite um produto/serviço existente e marque como item adicional, quando disponível na tela).
2. Preencha todos os campos.
3. Escolha o **Tipo de transação** (Venda, Locação ou Serviço).
4. Opcional: ative **Espelhar quantidade do item principal** se a qty do adicional deve acompanhar a do principal.
5. Adicione a **imagem de capa** (apenas uma), escolhendo na **galeria da loja**.
6. Em **“Pode ser adicionado junto com”**, selecione os produtos/serviços ou kits com os quais este item pode ser vendido. **Os anúncios em que o item aparecerá são definidos automaticamente** (como nas coleções): o item passa a figurar em todos os anúncios que contêm pelo menos uma das opções selecionadas. É necessário selecionar pelo menos uma opção.

## Importação por planilha ou CSV

- O modelo de importação possui a coluna **“Item adicional”**.
- Valores aceitos: **Sim** ou **Não** (ou equivalentes como true/false, 1/0).
- Se **Sim**, o produto/serviço daquela linha será criado como item adicional; as regras acima (sem calendário, sem frete, apenas capa) são aplicadas automaticamente.
- Na planilha, use **uma única imagem (URL)** na coluna de imagem; itens adicionais usam só a capa (a imagem deve ser da galeria da loja quando cadastrada pelo formulário).
- Ao mapear as colunas na tela de importação, associe a coluna **“Item adicional”** do seu arquivo ao campo **“Item adicional”** do mapeamento.

Consulte a documentação de importação de produtos/serviços para o passo a passo completo do uso da planilha ou CSV.

## Resumo para o vendedor

Carrinho: Item adicional só pode estar no carrinho se houver pelo menos um produto principal. |
Pode junto com: Selecione produtos/serviços ou kits; o adicional só pode ser adicionado junto com um deles. |
Anúncios: Definidos automaticamente (todos os anúncios que contêm alguma das opções selecionadas).
Calendário / Frete: Não se aplicam a itens adicionais.
Espelhar quantidade: Opcional; acompanha a qty do principal no carrinho.
Imagem: Apenas uma imagem (capa), escolhida da galeria da loja.
Importação: Coluna **“Item adicional”**: Sim ou Não; validação igual às demais colunas do modelo.