# Risoluzione dei problemi: gruppi di bundle (Bundle Groups)

### ✅ Prima di iniziare (checklist rapida)

Controlla prima questi punti

* Il bundle è configurato come **gruppo di bundle** (prodotto principale + componenti salvati)
* Hai selezionato le varianti corrette (non solo i titoli dei prodotti)
* L'opzione **Monitora quantità (Track quantity)** è abilitata per tutte le varianti componente in Shopify
* Le quantità dei componenti sono corrette (×1, ×2, ×3…)
* Stai controllando la sede Shopify corretta (se usi più sedi)

***

### 🛠 Caso 1: impossibile creare i gruppi di bundle

Se non riesci a creare un gruppo di bundle o un gruppo di sincronizzazione dell'inventario, assicurati che tutte le informazioni richieste siano configurate correttamente.

**Checklist:**

* Il gruppo deve includere almeno 2 varianti.

**Esempio**:&#x20;

Non è possibile creare un bundle con una sola variante di prodotto (ad es. solo "T-shirt Blue – Small"). Ne servono almeno due (ad es. "T-shirt Blue – Small" e "T-shirt Blue – Large").

Il gruppo deve avere almeno una sede attiva e l'inventario di quella sede non deve essere vuoto.

**Esempio***:*&#x20;

Se per la tua sede "Main Warehouse" non è stato inserito alcun valore di inventario, il sistema non può calcolare le scorte iniziali del gruppo.

Ogni variante può appartenere a un solo gruppo.

***

### 🛠  **Caso 2: scansione, importazione, esportazione o report non funzionano**

Se la scansione, l'importazione, l'esportazione o il report non si avviano o sembrano bloccati:

| È possibile eseguire una sola attività alla volta.     | Attendi che il processo in background attuale sia terminato prima di avviarne uno nuovo.                                                                                                                                                        | Se stai già importando un file CSV di grandi dimensioni, eseguire contemporaneamente una "Scansione" non andrà a buon fine finché l'importazione non è completata. |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Queste azioni vengono eseguite in background. | Riceverai una notifica via e-mail al termine dell'attività.                                                                                                                                                                         | Dopo aver eseguito "Esporta gruppi di inventario", controlla la tua casella di posta: il sistema invierà un link di download quando sarà pronto.  |
| Non hai ricevuto l'e-mail?            | <p>1. Controlla l'indirizzo e-mail nella scheda <strong>Impostazioni (Settings)</strong> dell'app per assicurarti che sia corretto.<br> 2. Controlla la cartella <strong>spam</strong> o <strong>promozioni</strong>: alcuni provider di posta filtrano le notifiche delle attività.</p> | Se non vedi l'e-mail del report di esportazione, controlla la cartella Spam o verifica l'indirizzo nelle Impostazioni.                    |

***

### 🛠 Caso 3: modifiche impreviste all'inventario

Se i numeri dell'inventario cambiano in modo imprevisto tra prodotto principale e prodotti componente, di solito è dovuto a un evento di sincronizzazione attivato.

Ti consigliamo di aprire la scheda **Cronologia (History)** nell'app per verificare quale evento ha causato la modifica.\
**Esempio***:* potresti vedere che l'inventario di "Bundle A" è diminuito perché è stato creato un ordine contenente "Master Product A".

**Nota:**\
I record della cronologia vengono eliminati automaticamente dopo **2 mesi**, quindi le modifiche più vecchie non saranno più visibili.

Se sospetti un ciclo di sincronizzazione o una modifica imprevista, prova a controllare gli ordini recenti o le modifiche effettuate tramite app di terze parti che potrebbero aver alterato le quantità delle scorte.

***

### 🛠  Caso 4: l'inventario del bundle (prodotto principale) è 0 ma i componenti hanno scorte

#### Perché succede

**Perché succede (più spesso)**

* Un componente è esaurito nella sede monitorata
* La quantità del componente è impostata in modo errato (ad es. dovrebbe essere ×2)
* Il monitoraggio dell'inventario è disabilitato per una variante componente

**Come risolvere**

1. Apri il gruppo di bundle e verifica ogni **variante componente**
2. Controlla l'inventario dei componenti in Shopify e assicurati che **Monitora quantità** sia abilitata
3. Verifica che le quantità richieste per ogni bundle siano corrette
4. Esegui **Aggiorna inventario del prodotto principale (Update Master Inventory)** per ricalcolare

✅ Esempio: se un bundle richiede **2× Product A**, le scorte di Product A limitano il bundle.

**🙋 Hai ancora bisogno di assistenza?**

Se hai ancora bisogno di aiuto, scrivici pure a <hi@tipo.io>. Saremo felici di aiutarti.
