# Synchronisatietriggers tussen Master- en componentproducten

Deze handleiding legt uit welke acties het synchroniseren in Bundle Groups activeren en wat de Tipo-app bijwerkt tussen het Master-product (bundel) en de bijbehorende componentproducten.

## ✅ Wat zijn “synchronisatietriggers”?

Een **synchronisatietrigger** is een gebeurtenis die de voorraad in Shopify wijzigt en ervoor zorgt dat Tipo Sync de bundel opnieuw berekent.

Simpel gezegd:

> **Er verandert iets aan de voorraad → Tipo detecteert dit → werkt Master en/of componenten bij**

***

## 🧩 Hoe synchroniseren werkt&#x20;

### 1. Synchroniseren van Master → componentproducten

Wanneer er iets verandert aan het **Master**-product, werkt het systeem de **componentproducten** dienovereenkomstig bij.

Zo wordt bij verkoop van een **Master** ook de voorraad van de **componenten** verlaagd.

#### 1.1. Bestelling aangemaakt

Wanneer een bestelling een Master-product bevat, wordt de bijbehorende hoeveelheid van elk componentproduct afgetrokken.

**Voorbeeld:**\
Als een Master-bundel “Gift Box” bestaat uit:

* 1 kaars
* 1 zeep

Wanneer een klant **2 Gift Boxes** bestelt, trekt het systeem automatisch **2 kaarsen** en **2 zepen** van de voorraad af.

#### **1.2. Terugbetaling / annulering van bestelling**

Als een bestelling met een Master-product wordt terugbetaald of geannuleerd en de optie **Restock** is ingeschakeld, worden de hoeveelheden van de componenten dienovereenkomstig hersteld.

**Voorbeeld:**\
Als 1 “Gift Box” is terugbetaald met restock ingeschakeld, dan stijgen de hoeveelheden kaarsen en zeep elk met 1.

#### **1.3. Locatie van bestelling gewijzigd**

Als de locatie van een bestelling wordt gewijzigd, werkt het systeem de voorraad op zowel de oude als de nieuwe locatie bij om de consistentie te bewaren.

**Voorbeeld:**\
Als een bestelling van Magazijn A naar Magazijn B wordt verplaatst, dan neemt de componentvoorraad in Magazijn A toe en die in Magazijn B af.

#### **1.4. Bestelling bewerken**

Als de bestelling met Master-producten wordt bewerkt:

* **Nieuwe producten toevoegen:** De componenthoeveelheden worden dienovereenkomstig aangepast.
* **Productaantallen bijwerken:** De componenthoeveelheden worden opnieuw berekend op basis van het nieuwe bestelaantal.

**Voorbeeld:**\
Als de bestelling oorspronkelijk 1 Gift Box bevatte en wordt aangepast naar 2, dan wordt de voorraad van elk component nog eens met 1 verlaagd.

***

### **2. Synchroniseren van Component → Master-producten**

Deze richting is van toepassing wanneer u de instelling **“Sync Component to Master”** inschakelt.\
Hierdoor wordt de hoeveelheid van de bijbehorende Master automatisch bijgewerkt wanneer de hoeveelheden van componenten veranderen.

#### **2.1. Bij het aanmaken of bijwerken van een bundel**

Wanneer u een Bundle Group aanmaakt of bewerkt, wordt de voorraad van de Master opnieuw berekend op basis van de beschikbare voorraad van alle componenten.

**Voorbeeld:**\
Als “Gift Box” = 1 kaars + 1 zeep

* Kaars = 10 stuks
* Zeep = 20 stuks\
  → Master “Gift Box”-voorraad = 10 (op basis van de laagste componenthoeveelheid).

#### **2.2. Bij klikken op “Update Master Inventory”**

U kunt de voorraad van de Master op elk moment handmatig vernieuwen door in de app op deze knop te klikken.\
Dit berekent de beschikbare hoeveelheid van de Master opnieuw op basis van de huidige componenthoeveelheden.

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

#### **2.3. Bestelling aangemaakt**

Als een bestelling componentproducten bevat (in plaats van de Master), berekent het systeem de beschikbare hoeveelheid van de Master opnieuw.

**Voorbeeld:**\
Als een klant 1 kaars koopt (een component van “Gift Box”), dan daalt ook de beschikbare hoeveelheid “Gift Box”, omdat een van de componenten nu lager is.

#### **2.4. Terugbetaling / annulering van bestelling**

Wanneer een bestelling met componenten wordt terugbetaald of geannuleerd met restock ingeschakeld, stijgt de hoeveelheid van de Master dienovereenkomstig.

#### **2.5. Locatie van bestelling gewijzigd**

Wanneer de bestellocatie van componentproducten wordt gewijzigd, past het systeem de voorraad van de Master aan om de wijzigingen op de nieuwe en oude locaties weer te geven.

#### **2.6. Bestelling bewerken**

Als de bestelling wordt bewerkt (bijvoorbeeld door de hoeveelheid te wijzigen of een component toe te voegen of te verwijderen), wordt de voorraad van de Master dienovereenkomstig opnieuw berekend.

***

### Niet-gesynchroniseerde gebeurtenissen

#### 1. Handmatige voorraadwijzigingen

Als u de voorraad van een product handmatig rechtstreeks in uw Shopify-beheer wijzigt, synchroniseert de app deze wijziging niet automatisch naar andere gerelateerde producten.\
**Reden:**&#x20;

* Handmatige wijzigingen buiten de app (bijvoorbeeld voorraad aanpassen in Shopify → **Products** → Inventory bewerken) worden niet als synchronisatiegebeurtenissen geregistreerd.
* De app houdt alleen wijzigingen bij die via bestellingen, terugbetalingen of app-acties zijn gedaan.

**Voorbeeld:**\
U verhoogt handmatig de voorraad van “Candle” (een component van “Gift Box”) van 10 → 20 in Shopify.\
→ De app werkt de hoeveelheid van “Gift Box” niet automatisch bij.\
Om de Master-voorraad na handmatige wijzigingen te vernieuwen, gaat u naar de app en klikt u op **“Update Master Inventory”**.

#### 2. Updates van apps van derden

Als een andere app (zoals een fulfilment-, magazijn- of voorraadbeheerapp) de productaantallen wijzigt, zorgt dit niet voor synchronisatie in de Tipo-app.

**Reden**:&#x20;

* De Tipo-app synchroniseert voorraad alleen wanneer hij specifieke Shopify-gebeurtenissen detecteert (zoals het aanmaken, terugbetalen of bewerken van een bestelling).\
  \- Apps van derden kunnen de voorraad via API of aangepaste scripts bijwerken, wat Shopify niet als standaard voorraadgebeurtenis classificeert.

**Voorbeeld:**\
U gebruikt een magazijnbeheerapp die de voorraad van “Soap” automatisch verlaagt wanneer deze voor verzending wordt ingepakt.\
→ Tipo Sync detecteert deze wijziging niet en past de voorraad van de Master “Gift Box” niet aan.\
In dit geval kunt u de synchronisatie handmatig vernieuwen door op **“Update Master Inventory”** te klikken of de bundle group opnieuw op te slaan.

#### 3. Conceptbestellingen

Wanneer u conceptbestellingen in Shopify aanmaakt, wordt de voorraad pas verlaagd als de bestelling daadwerkelijk is afgerond of betaald.\
Daarom start de app geen voorraadsynchronisatie voor conceptbestellingen.

**Reden:**

* Shopify behandelt conceptbestellingen als “niet afgerond”, dus de voorraad blijft ongewijzigd.
* Synchroniseren in dit stadium zou tot onjuiste voorraadniveaus kunnen leiden.

**Voorbeeld:**\
U maakt een conceptbestelling aan voor 2 Gift Boxes, maar hebt deze nog niet als betaald gemarkeerd.\
→ Tipo werkt de voorraad van de componenten (“Candle” en “Soap”) niet bij totdat de conceptbestelling een bevestigde bestelling wordt.\
Zodra de conceptbestelling is betaald of omgezet, verloopt de synchronisatie weer normaal.

**🙋 Heb je nog steeds ondersteuning nodig?**

Als je nog steeds hulp nodig hebt, neem dan gerust contact met ons op via <hi@tipo.io>. We helpen je graag verder.
