# Synkronoinnin laukaisijat Master- ja komponenttituotteiden välillä

Tämä ohje selittää, mitkä toimet käynnistävät synkronoinnin Bundle Groupeissa ja mitä Tipo-sovellus päivittää Master (paketti) -tuotteen ja sen komponenttituotteiden välillä.

## ✅ Mitä ovat “synkronoinnin laukaisijat”?

**Synkronoinnin laukaisija** on tapahtuma, joka muuttaa varastoa Shopifyssa ja saa Tipo Syncin laskemaan paketin uudelleen.

Yksinkertaisesti sanottuna:

> **Jokin muuttaa varastoa → Tipo havaitsee sen → päivittää Masterin ja/tai komponentit**

***

## 🧩 Miten synkronointi toimii&#x20;

### 1.Synkronointi Master → komponenttituotteet

Kun **Master**-tuotteeseen tehdään muutos, järjestelmä päivittää vastaavasti **komponenttituotteet**.

Tämä varmistaa, että kun **Master** myydään, sen **komponentit** vähennetään myös varastosta.

#### 1.1. Tilaus luotu

Kun tilaus sisältää Master-tuotteen, kunkin komponenttituotteen vastaava määrä vähennetään.

**Esimerkki:**\
Jos Master-paketti “Gift Box” sisältää:

* 1 Candle
* 1 Soap

Kun asiakas tilaa **2 Gift Boxia**, järjestelmä vähentää automaattisesti varastosta **2 Candlea** ja **2 Soapia**.

#### **1.2. Tilauksen hyvitys / tilauksen peruutus**

Jos Master-tuotteen sisältävä tilaus hyvitetään tai peruutetaan ja **Restock**-asetus on käytössä, komponenttien määrät palautetaan vastaavasti.

**Esimerkki:**\
Jos 1 “Gift Box” hyvitettiin Restock-asetuksen ollessa käytössä, sekä Candlen että Soapin määrät kasvavat yhdellä.

#### **1.3. Tilauksen sijainnin muutos**

Jos tilauksen sijainti muuttuu, järjestelmä päivittää varaston sekä vanhalla että uudella sijainnilla johdonmukaisuuden varmistamiseksi.

**Esimerkki:**\
Jos tilaus siirtyy varastosta A varastoon B, komponenttien varasto varastossa A kasvaa ja varasto varastossa B vähenee.

#### **1.4. Tilauksen muokkaus**

Jos Master-tuotteita sisältävää tilausta muokataan:

* **Lisää uusia tuotteita:** Komponenttien määriä säädetään vastaavasti.
* **Päivitä tuotteiden määriä:** Komponenttien määrät lasketaan uudelleen uuden tilausmäärän perusteella.

**Esimerkki:**\
Jos tilauksessa oli alun perin 1 Gift Box ja se päivitetään 2:een, komponenttien varastoa vähennetään jokaisesta vielä yhdellä.

***

### **2. Synkronointi Komponentti → Master-tuotteet**

Tämä suunta koskee tilannetta, jossa otat käyttöön asetuksen **“Sync Component to Master”**.\
Se varmistaa, että kun komponenttien määrät muuttuvat, vastaavan Masterin määrä päivittyy automaattisesti.

#### **2.1. Paketin luominen tai päivittäminen**

Kun luot tai muokkaat Bundle Groupia, Masterin varasto lasketaan uudelleen kaikkien komponenttien saatavilla olevan varaston perusteella.

**Esimerkki:**\
Jos “Gift Box” = 1 Candle + 1 Soap

* Candle = 10 kpl
* Soap = 20 kpl\
  → Master “Gift Box” -varasto = 10 (alimman komponentin määrän perusteella).

#### **2.2. Kun klikkaat “Update Master Inventory”**

Voit päivittää Masterin varaston manuaalisesti milloin tahansa klikkaamalla tätä painiketta sovelluksessa.\
Tämä laskee Masterin saatavilla olevan määrän uudelleen nykyisten komponenttien määrien perusteella.

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

#### **2.3. Tilaus luotu**

Jos tilaus sisältää komponenttituotteita (Masterin sijaan), järjestelmä laskee Masterin saatavilla olevan määrän uudelleen.

**Esimerkki:**\
Jos asiakas ostaa 1 Candlen (“Gift Box” -paketin komponentti), myös saatavilla oleva “Gift Box” -määrä pienenee, koska yksi sen komponenteista on nyt alhaisempi.

#### **2.4. Tilauksen hyvitys / tilauksen peruutus**

Kun komponentteja sisältävä tilaus hyvitetään tai peruutetaan ja Restock-asetus on käytössä, Masterin määrä kasvaa vastaavasti.

#### **2.5. Tilauksen sijainnin muutos**

Kun komponenttituotteiden tilauksen sijainti muuttuu, järjestelmä säätää Masterin varastoa vastaamaan muutoksia uudessa ja vanhassa sijainnissa.

#### **2.6. Tilauksen muokkaus**

Jos tilausta muokataan (esim. määrää muutetaan tai komponentti lisätään/poistetaan), Masterin varasto lasketaan uudelleen vastaavasti.

***

### Synkronoimattomat tapahtumat

#### 1.Manuaaliset varastomuutokset

Jos muutat tuotteen varastoa suoraan Shopify-hallinnassa, sovellus ei synkronoi tätä muutosta automaattisesti muihin liittyviin tuotteisiin.\
**Syy:**&#x20;

* Sovelluksen ulkopuolella tehdyt manuaaliset muutokset (esim. varaston säätö Shopifyssa → **Products** → Edit inventory) eivät tallennu synkronointitapahtumina.
* Sovellus seuraa vain tilausten, hyvitysten tai sovelluksen toimien kautta tehtyjä muutoksia.

**Esimerkki:**\
Lisäät manuaalisesti Shopifyssa “Candle”-tuotteen varastoa (“Gift Box” -paketin komponentti) 10 → 20.\
→ Sovellus ei päivitä “Gift Box” -määrää automaattisesti.\
Päivitä Masterin varasto manuaalisten muutosten jälkeen siirtymällä sovellukseen ja klikkaamalla **“Update Master Inventory”**.

#### 2.Kolmannen osapuolen sovellusten päivitykset

Jos toinen sovellus (kuten toimitus-, varasto- tai varastonhallintasovellus) muuttaa tuotteen määrää, tämä ei käynnistä synkronointia Tipo-sovelluksessa.

**Syy**:&#x20;

* Tipo-sovellus synkronoi varaston vain, kun se havaitsee tiettyjä Shopify-tapahtumia (kuten tilauksen luonti, hyvitys tai muokkaus).\
  \- Kolmannen osapuolen sovellukset voivat päivittää varastoa API:n tai mukautettujen skriptien kautta, joita Shopify ei luokittele tavallisiksi varastotapahtumiksi.

**Esimerkki:**\
Käytät varastonhallintasovellusta, joka vähentää “Soap”-tuotteen varastoa automaattisesti, kun se pakataan lähetettäväksi.\
→ Tipo Sync ei havaitse tätä muutosta eikä säädä Masterin “Gift Box” -varastoa.\
Tässä tapauksessa voit päivittää synkronoinnin manuaalisesti klikkaamalla **“Update Master Inventory”** tai tallentamalla paketin uudelleen.

#### 3.Luonnostilaukset

Kun luot Shopifyssa luonnostilauksia, varastoa ei vähennetä ennen kuin tilaus on todella valmis tai maksettu.\
Siksi sovellus ei käynnistä synkronointia luonnostilauksille.

**Syy:**

* Shopify käsittelee luonnostilauksia “ei lopullisina”, eli varasto pysyy ennallaan.
* Synkronointi tässä vaiheessa voisi aiheuttaa virheellisiä varastotasoja.

**Esimerkki:**\
Luot luonnostilauksen 2 Gift Boxille, mutta et ole vielä merkinnyt sitä maksetuksi.\
→ Tipo ei päivitä komponenttien (“Candle” ja “Soap”) varastoa ennen kuin luonnostilauksesta tulee vahvistettu tilaus.\
Kun luonnostilaus on maksettu tai muunnettu, synkronointi toimii normaalisti.

**🙋 Tarvitsetko yhä tukea?**

Jos tarvitset edelleen apua, ota meihin rohkeasti yhteyttä osoitteeseen <hi@tipo.io>. Autamme mielellämme lisää.
