# Kits

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

Kits permitem agrupar vários produtos ou serviços em uma única oferta.

## O que são Kits?

Kits permitem agrupar vários produtos ou serviços em uma única oferta. Isso pode ser útil para:

- Criar pacotes promocionais
- Oferecer soluções completas para eventos
- Compartilhar estoque entre itens

## Quando Usar Kits?

- Quando você tem versões de um produto ou serviço que utilizam o mesmo estoque
- Quando precisa consultar agendas/calendários simultâneos
- Quando quer criar pacotes promocionais
- Quando quer oferecer soluções completas

## Criando um Kit

Para montar sua composição:

1. Escolha um produto ou serviço
2. Informe a quantidade deste item no kit
3. Repita para cada produto/serviço até completar toda composição do seu kit

**Dica:** use nomes claros nas peças (ex.: “Cilindros”) e um nome de pacote no kit (ex.: “Pegue e monte”). Assim fica fácil achar cada coisa na listagem e no anúncio.

### Criar kit a partir da seleção na listagem

Você também pode montar um kit **selecionando vários produtos/serviços de uma vez** na listagem (**Meus Produtos/Serviços**), sem abrir o formulário do zero.

1. Acesse **Meus Produtos/Serviços**.
2. Marque **pelo menos 2** itens ativos (na **grade** em computador, ou na vista em cards com as caixas de seleção).
3. Na barra de ações da seleção, clique em **Criar kit**.
4. O sistema abre a tela de criação do kit com os itens já na composição. Se o seu plano permitir sugestões com IA, título, descrição e preço podem ser pré-preenchidos — revise e ajuste antes de salvar.
5. Confira quantidades, frete e demais campos e salve o kit.

**Regras da seleção:**

- Só entram itens **ativos** e que **não** sejam itens adicionais.
- Todos devem ser do **mesmo tipo** (venda, locação ou serviço).
- Em celular, a seleção em lote da grade pode não aparecer — use um computador (tela larga) ou a vista em cards, se disponível.

Depois de criar o kit, inclua-o em um **anúncio** para o comprador vê-lo na vitrine. Veja também [Anúncios](./anuncios.md).

## Ações em lote em Meus Kits

Na listagem **Meus Kits**, cada card tem uma caixa de seleção no canto superior esquerdo. A seleção **acumula** entre páginas e filtros: você pode buscar por título, trocar de coleção ou limpar a busca sem perder o que já marcou. A barra que aparece acima da lista mostra o resumo do que está selecionado e permite:

- **Selecionar todos na página** — inclui de uma vez os kits ativos visíveis.
- **Criar anúncio** — abre o novo anúncio com os kits marcados como opções (com sugestão da IA, se o plano permitir).
- **Excluir** — manda todos os kits marcados para a lixeira de uma vez.
- **Limpar seleção** — zera tudo.

Na vista em **grade**, cada linha tem os botões de **editar**, **detalhes**, **duplicar** e **excluir**; as caixas de seleção da grade continuam servindo à **edição em massa** de preço, quantidades e embalagem.

## Disponibilidade do Kit

Um kit só estará disponível se **todos** os itens que o compõem estiverem disponíveis.

### KITS - Regras de Disponibilidade

- **Itens com Estoque**: É necessário ter a quantidade especificada de cada item
- **Itens com Calendário**: É necessário que todos estejam disponíveis no mesmo período
- **Quantidade > 1 com várias agendas (hora / dia / período):**  
  Quando o componente tem **calendário habilitado**, **estoque desabilitado** e unidade de preço **`hour`**, **`day`** ou **`period`** (por hora, por dia ou por período), a **quantidade na composição do kit** significa: quantas **agendas distintas** desse produto/serviço precisam estar **livres no mesmo período**.  
  - O produto/serviço precisa ter **pelo menos N calendários** vinculados (N = quantidade no kit × quantidade pedida).  
  - O sistema **não** aceita reutilizar a mesma agenda para preencher a quantidade: as agendas escolhidas naquele horário têm de ser **diferentes**.  
  - Demais unidades (`unit`, pessoa, kit, etc.): a quantidade **não** mapeia para “N agendas”; segue as regras gerais de estoque/calendário.

**Exemplo (1 produto/serviço no kit, qtdade 2):**  
Serviço “DJ / recreador”, cobrado **por período** (ou por hora/dia), sem estoque, com **2 calendários** (José e Ana). No kit, composição com quantidade **2**.  
→ No mesmo horário precisam estar livres **José e Ana** (duas agendas distintas). Se só um estiver livre, o kit fica indisponível.

**Exemplo (oficinas):**  
As mesmas agendas José e Ana podem ser reutilizadas em várias oficinas. Um kit “Oficina — 2 recreadores” com qty 2 nesse serviço exige as duas agendas no mesmo período — sem criar agenda nova por oficina.

Isso é diferente de vários **pacotes alternativos** (2h vs 4h) na **mesma** agenda: aí o comprador escolhe **uma** opção e ocupa um recurso.

Veja também [Estoque e disponibilidade — Kits](./estoque-disponibilidade.md#disponibilidade-em-kits) e [Guia de configuração de calendários](../calendarios/guia-de-configuracao-de-calendarios.md).

### Cálculo de Duração do Kit

Para considerar um kit disponível, consideramos a **maior duração possível**, de acordo com sua composição.

#### Exemplo 1

Kit composto por:
- 1 Tenda, por período, duração fixa de 4 horas
- 1 Equipamento de iluminação, por dia, duração mínima de 1 dia e máxima de 2 dias
- 2 Assistentes de montagem, por período, duração fixa de 6 horas

**Duração deste kit**: Fixa de 2 dias

#### Exemplo 2

Kit composto por:
- 1 recreador, duração fixa de 2 horas
- 1 pula-pula, por dia, duração mínima de 3 horas e máxima de 4 horas

**Duração deste kit**: Mínima de 3 horas e máxima de 4 horas

## Frete em Kits

- Você pode configurar opções de frete ou entrega no kit.
- As configurações de frete do kit **substituem** as configurações individuais dos produtos/serviços do pacote no anúncio do kit.

### Quando o frete do pacote é diferente das peças

Se o **custo**, as **faixas/raios** ou a **caixa** do kit forem diferentes das peças avulsas:

1. Em **Fretes**, crie (ou duplique) um **grupo de frete** para o pacote (ex.: “Deslocamento — Kit festa”).
2. Ajuste **faixas e valores** desse grupo para o pacote.
3. No **kit**, habilite frete e selecione esse grupo.

Nas peças, mantenha o frete delas se também forem vendidas/alugadas separadas.

### Frete terceirizado e medidas de caixa do kit

Na cotação com transportadora, o sistema usa peso/medidas do **kit** (ou a embalagem padrão do grupo de frete do kit) — **não** soma as caixas das peças.

1. Crie um grupo de frete (ou ajuste a embalagem padrão) com a **caixa do pacote**.
2. No kit, marque como físico quando fizer sentido e preencha **peso e medidas** (ou itens por caixa) do pacote.
3. Nas peças, deixe as medidas individuais para anúncios avulsos.

Veja também [Configurando fretes](../fretes/configurando-fretes.md).