# Solução de problemas: Bundle Groups

### ✅ Antes de começar (checklist rápido)

Verifique estes pontos primeiro

* O bundle está configurado como um **Bundle Group** (Master + Componentes salvos)
* Você selecionou as variantes corretas (não apenas os títulos dos produtos)
* **Track quantity** está habilitado para todas as variantes de componentes na Shopify
* As quantidades dos componentes estão corretas (×1, ×2, ×3…)
* Você está verificando o local correto na Shopify (se usar vários locais)

***

### 🛠 Caso 1: Não é possível criar Bundle Groups

Se você não conseguir criar um Bundle ou Inventory Sync Group, verifique se todas as informações obrigatórias estão configuradas corretamente.

**Checklist:**

* O grupo deve incluir pelo menos 2 variantes.

**Exemplo**:&#x20;

Um bundle com apenas uma variante de produto (por exemplo, apenas “T-shirt Blue – Small”) não pode ser criado. Você precisa de pelo menos duas (por exemplo, “T-shirt Blue – Small” e “T-shirt Blue – Large”).

O grupo deve ter pelo menos um local ativo, e o estoque desse local não pode estar em branco.

**Exemplo***:*&#x20;

Se o seu local “Main Warehouse” não tiver nenhum número de estoque informado, o sistema não consegue calcular o estoque inicial do grupo.

Cada variante pode pertencer a apenas um grupo.

***

### 🛠  **Caso 2: Scan, Import, Export ou Report não estão funcionando**

Se a sua função de scan, importação, exportação ou relatório não iniciar ou parecer travada:

| Apenas uma tarefa pode ser executada por vez.     | Aguarde até que o processo em segundo plano atual seja concluído antes de iniciar um novo. | Se você já estiver importando um CSV grande, executar um “Scan” ao mesmo tempo falhará até que a importação seja concluída. |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Estas ações são executadas em segundo plano. | Você receberá uma notificação por e-mail assim que a tarefa for concluída. | Depois de executar “Export Inventory Groups”, verifique sua caixa de entrada: o sistema enviará um link de download quando estiver pronto. |
| Não recebeu o e-mail? | <p>1. Verifique o endereço de e-mail na aba <strong>Settings</strong> do app para garantir que esteja correto.<br> 2. Verifique sua pasta de <strong>spam</strong> ou <strong>promoções</strong>; alguns provedores de e-mail filtram notificações de tarefas.</p> | Se você não vir o e-mail do relatório de exportação, procure na pasta de Spam ou confirme o endereço em Settings. |

***

### 🛠 Caso 3: Alterações inesperadas de estoque

Se os números de estoque mudarem inesperadamente entre produtos Master e Componentes, normalmente isso se deve a um evento de sincronização acionado.

Sugerimos que você abra a aba **History** no app para revisar qual evento causou a mudança.\
**Exemplo***:* você pode ver que o estoque de “Bundle A” diminuiu porque um pedido contendo “Master Product A” foi criado.

**Observação:**\
Os registros do histórico são excluídos automaticamente após **2 meses**, então as alterações mais antigas não aparecerão mais.

Se você suspeitar de um loop de sincronização ou de um ajuste inesperado, tente revisar pedidos recentes ou edições feitas por apps de terceiros que possam ter alterado as quantidades de estoque.

***

### 🛠  Caso 4: O estoque do bundle (Master) está em 0, mas os componentes têm estoque

#### Por que isso acontece

**Por que isso acontece (na maioria das vezes)**

* Um componente está esgotado no local rastreado
* A quantidade do componente está configurada incorretamente (por exemplo, deveria ser ×2)
* O rastreamento de estoque está desabilitado para uma variante de componente

**Como resolver**

1. Abra o Bundle Group e confirme cada **variante de componente**
2. Verifique o estoque dos componentes na Shopify e certifique-se de que **Track quantity** está habilitado
3. Confirme se as quantidades necessárias por bundle estão corretas
4. Execute **Update Master Inventory** para recalcular

✅ Exemplo: se um bundle precisa de **2× Product A**, então o estoque do Product A limita o bundle.

**🙋 Ainda precisa de suporte?**

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