# Rozwiązywanie problemów: Bundle Groups

### ✅ Zanim zaczniesz (szybka lista kontrolna)

Najpierw sprawdź

* Pakiet jest skonfigurowany jako **Bundle Group** (Master + komponenty zapisane)
* Wybrano odpowiednie warianty (nie tylko tytuły produktów)
* **Track quantity** jest włączone dla wszystkich wariantów komponentów w Shopify
* Ilości komponentów są prawidłowe (×1, ×2, ×3…)
* Sprawdzasz właściwą lokalizację w Shopify (jeśli używasz wielu lokalizacji)

***

### 🛠 Przypadek 1: Nie można utworzyć Bundle Groups

Jeśli nie możesz utworzyć pakietu ani grupy synchronizacji stanów, upewnij się, że wszystkie wymagane informacje są prawidłowo skonfigurowane.

**Lista kontrolna:**

* Grupa musi zawierać co najmniej 2 warianty.

**Przykład**:&#x20;

Pakietu z tylko jednym wariantem produktu (np. samym „T-shirt Blue – Small”) nie można utworzyć. Potrzebujesz co najmniej dwóch (np. „T-shirt Blue – Small” i „T-shirt Blue – Large”).

Grupa musi mieć co najmniej jedną aktywną lokalizację, a stan magazynowy tej lokalizacji nie może być pusty.

**Przykład***:*&#x20;

Jeśli w lokalizacji „Main Warehouse” nie wpisano stanu magazynowego, system nie może obliczyć stanu początkowego grupy.

Każdy wariant może należeć tylko do jednej grupy.

***

### 🛠  **Przypadek 2: Skanowanie, import, eksport lub raport nie działa**

Jeśli funkcja skanowania, importu, eksportu lub raportu nie uruchamia się albo wydaje się zawieszona:

| Tylko jedno zadanie może działać naraz. | Poczekaj, aż bieżący proces w tle zostanie zakończony, zanim rozpoczniesz kolejny. | Jeśli importujesz już duży plik CSV, uruchomienie „Scan” w tym samym czasie zakończy się niepowodzeniem, dopóki import nie zostanie ukończony. |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Te działania są wykonywane w tle. | Otrzymasz powiadomienie e-mail po zakończeniu zadania. | Po uruchomieniu „Export Inventory Groups” sprawdź skrzynkę e-mail; system wyśle link do pobrania, gdy plik będzie gotowy.  |
| Nie otrzymałeś e-maila? | <p>1. Sprawdź adres e-mail w zakładce <strong>Settings</strong> aplikacji, aby upewnić się, że jest poprawny.<br> 2. Sprawdź folder <strong>spam</strong> lub <strong>promocje</strong>; niektórzy dostawcy poczty filtrują powiadomienia o zadaniach.</p> | Jeśli nie widzisz e-maila z raportem eksportu, sprawdź folder Spam lub zweryfikuj adres w Settings. |

***

### 🛠 Przypadek 3: Nieoczekiwane zmiany stanu magazynowego

Jeśli stany magazynowe zmieniają się nieoczekiwanie między produktami Master a produktami składowymi, zwykle wynika to z uruchomionego zdarzenia synchronizacji.

Zalecamy otwarcie zakładki **History** w aplikacji, aby sprawdzić, które zdarzenie spowodowało zmianę.\
**Przykład***:* Możesz zobaczyć, że stan „Bundle A” spadł, ponieważ utworzono zamówienie zawierające „Master Product A”.

**Uwaga:**\
Wpisy historii są automatycznie usuwane po **2 miesiącach**, więc starsze zmiany nie będą się już pojawiać.

Jeśli podejrzewasz pętlę synchronizacji lub nieoczekiwaną korektę, sprawdź ostatnie zamówienia lub zmiany wykonane przez aplikacje zewnętrzne, które mogły zmodyfikować stany magazynowe.

***

### 🛠  Przypadek 4: Stan magazynowy pakietu (Master) to 0, ale komponenty mają zapasy

#### Dlaczego to się dzieje

**Dlaczego to się dzieje (najczęściej)**

* Komponent jest niedostępny w śledzonej lokalizacji
* Ilość komponentu jest ustawiona nieprawidłowo (np. powinno być ×2)
* Śledzenie stanu jest wyłączone dla wariantu komponentu

**Jak rozwiązać problem**

1. Otwórz Bundle Group i sprawdź każdy **wariant komponentu**
2. Sprawdź stan magazynowy komponentów w Shopify i upewnij się, że **Track quantity** jest włączone
3. Potwierdź, że wymagane ilości na pakiet są prawidłowe
4. Uruchom **Update Master Inventory**, aby przeliczyć stan

✅ Przykład: Jeśli pakiet wymaga **2× Product A**, to stan Product A ogranicza dostępność pakietu.

**🙋 Nadal potrzebujesz pomocy?**

Jeśli nadal potrzebujesz pomocy, skontaktuj się z nami pod adresem <hi@tipo.io>. Chętnie pomożemy.
