# Small Planter Kit - Bundle Group

Este guia apresenta um exemplo detalhado de como usar um Bundle Group para calcular o estoque de um produto em kit com base no estoque dos seus componentes individuais.

### Caso

Este cenário envolve um produto principal em kit ("Small Planter Kit") cujo estoque deve ser calculado com base no estoque disponível de dois produtos componentes ("Wooden Panel" e "Bag of Soil").

<figure><img src="/media/7296f19d585da486b19b.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

| Tipo          | Nome do produto       | SKU         | Estoque atual  | Papel no kit                                      |
| ------------- | --------------------- | ----------- | -------------- | ------------------------------------------------- |
| **Bundle**    | **Small Planter Kit** | `KIT-PLN01` | 0 (calculado)  | *Produto principal (o estoque precisa ser definido)* |
| **Component** | Wooden Panel          | `PNL-WOOD`  | 80             | *Necessário: 4 painéis por kit*                   |
| **Component** | Bag of Soil           | `BAG-SOIL`  | 45             | *Necessário: 1 saco por kit*                      |

* **O problema:** o **Small Planter Kit** está listado na sua loja, mas você não consegue controlar o estoque manualmente sem verificar constantemente o estoque dos componentes individuais (painel e saco de substrato).
* **O objetivo:** criar um **Bundle Group** que use o estoque de `PNL-WOOD` e `BAG-SOIL` para calcular com precisão o estoque máximo disponível para o kit `KIT-PLN01`.

### Solução: crie um Bundle Group

Vamos criar um novo Bundle Group no Tipo Sync para definir a receita do produto `KIT-PLN01`.

**Etapas**

1. Abra o app > clique em Bundle Groups > clique no botão **New** **Bundle Group**
2. Digite um **Title** e selecione o **Status** como **Active**
3. No campo **Master Variant**, pesquise e selecione o produto principal: **Small Planter Kit** (`KIT-PLN01`)

<figure><img src="/media/c19c08bef254481dd1c9.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

4. Na seção Add Component Variants, adicione os produtos **Component** (a receita)

* **Componente 1 (Wooden Panel):**
  * Pesquise e selecione: **Wooden Panel** (`PNL-WOOD`).
  * Defina **Quantity Required:** digite `4` (já que o kit exige quatro painéis).
* **Componente 2 (Bag of Soil):**
  * Clique em **Add New Component** novamente.
  * Pesquise e selecione: **Bag of Soil** (`BAG-SOIL`).
  * Defina **Quantity Required:** digite `1` (já que o kit exige um saco de substrato).

<figure><img src="/media/02a1208941c0807deb0a.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

5. Salve o bundle group.

O Tipo Sync agora calculará o estoque disponível de `KIT-PLN01` e enviará esse número para a sua loja.

### Resultado: cálculo de estoque e atualização em tempo real

O Tipo Sync usa um cálculo de fator limitante: ele verifica quantos conjuntos completos podem ser montados a partir dos componentes disponíveis.

**1 - O cálculo inicial**

| Componente                | Estoque atual | Quantidade necessária por conjunto | Conjuntos disponíveis (estoque / quantidade necessária) | Fator limitante |
| ------------------------- | ------------- | ---------------------------------- | ------------------------------------------------------- | --------------- |
| Wooden Panel (`PNL-WOOD`) | **80**        | 4                                  | 80 / 4 = **20**                                         | **Limite**      |
| Bag of Soil (`BAG-SOIL`)  | **45**        | 1                                  | 45 / 1 = **45**                                         |                 |
| **RESULTADO DO KIT**      |               |                                    | **Conjuntos disponíveis calculados**                    | **20**          |

**2 - Exemplo de atualização de estoque em tempo real**

Se um cliente comprar **5** Small Planter Kits:

<table data-header-hidden><thead><tr><th></th><th width="110.0242919921875"></th><th width="141.3134765625"></th><th></th><th></th></tr></thead><tbody><tr><td>Produto</td><td>Antes da venda</td><td>Quantidade vendida</td><td>Dedução do estoque</td><td>Após a sincronização</td></tr><tr><td><strong>Small Planter Kit</strong> (<code>KIT-PLN01</code>)</td><td>20</td><td>5 kits vendidos</td><td>N/D (calculado)</td><td><strong>15</strong> (novo estoque calculado)</td></tr><tr><td>Wooden Panel (<code>PNL-WOOD</code>)</td><td>80</td><td>N/D</td><td>5 kits * 4 painéis = <strong>20</strong></td><td><strong>60</strong></td></tr><tr><td>Bag of Soil (<code>BAG-SOIL</code>)</td><td>45</td><td>N/D</td><td>5 kits * 1 saco = <strong>5</strong></td><td><strong>40</strong></td></tr></tbody></table>

O Tipo Sync reduz instantaneamente o estoque dos componentes (painéis em 20, sacos de substrato em 5) e depois recalcula o novo estoque do kit (15) e o envia para a loja, garantindo que seus níveis de estoque estejam sempre precisos.

**🙋 Ainda precisa de suporte?**

Se ainda precisar de ajuda, entre em contato conosco pelo e-mail <hi@tipo.io>. Teremos prazer em ajudar você.
