# Master ve Component ürünleri arasındaki senkronizasyon tetikleyicileri

Bu kılavuz, Bundle Group’larda hangi işlemlerin senkronizasyonu tetiklediğini ve Tipo uygulamasının Master (paket) ürün ile bileşen ürünleri arasında neyi güncellediğini açıklar.

## ✅ “Senkronizasyon tetikleyicileri” nedir?

**Senkronizasyon tetikleyicisi**, Shopify’da envanteri değiştiren ve Tipo Sync’in paketi yeniden hesaplamasına neden olan bir olaydır.

Basitçe söylemek gerekirse:

> **Bir stok değişir → Tipo bunu algılar → Master ve/veya bileşenleri günceller**

***

## 🧩 Senkronizasyon nasıl çalışır&#x20;

### 1. Master → Component ürünlerine senkronizasyon

**Master** üründe bir değişiklik olduğunda sistem, **Component** ürünlerini buna göre günceller.

Bu sayede bir **Master** satıldığında **Component** ürünlerinin stoğu da düşülür.

#### 1.1. Sipariş oluşturuldu

Bir sipariş Master ürün içerdiğinde, her Component ürününden ilgili miktar düşülür.

**Örnek:**\
“Gift Box” adlı bir Master paket şunları içeriyorsa:

* 1 Candle
* 1 Soap

Bir müşteri **2 Gift Box** sipariş ederse sistem envanterden otomatik olarak **2 Candle** ve **2 Soap** düşer.

#### **1.2. Sipariş iadesi / Sipariş iptali**

Master ürün içeren bir sipariş iade edilir veya iptal edilir ve **Restock** seçeneği açıksa, bileşenlerin miktarları buna göre geri yüklenir.

**Örnek:**\
Restock açıkken 1 “Gift Box” iade edilirse, hem Candle hem Soap miktarı 1 artar.

#### **1.3. Sipariş konumunun değiştirilmesi**

Bir siparişin konumu değiştirilirse sistem tutarlılığı sağlamak için hem eski hem yeni konumdaki envanteri günceller.

**Örnek:**\
Sipariş Depo A’dan Depo B’ye taşınırsa, Depo A’daki Component envanteri artar, Depo B’deki envanter azalır.

#### **1.4. Sipariş düzenleme**

Master ürünler içeren bir sipariş düzenlenirse:

* **Yeni ürün ekleme:** Component miktarları buna göre ayarlanır.
* **Ürün miktarlarını güncelleme:** Component miktarları yeni sipariş miktarına göre yeniden hesaplanır.

**Örnek:**\
Siparişte başlangıçta 1 Gift Box varsa ve bu 2’ye güncellenirse, Component envanteri her biri için 1 adet daha azalır.

***

### **2. Component → Master ürünlerine senkronizasyon**

Bu yön, **“Sync Component to Master”** ayarını etkinleştirdiğinizde geçerlidir.\
Bileşen miktarları değiştiğinde ilgili Master’ın miktarının otomatik olarak güncellenmesini sağlar.

#### **2.1. Paket oluşturduğunuzda veya güncellediğinizde**

Bir Bundle Group oluşturduğunuzda veya düzenlediğinizde, Master envanteri tüm Component’lerin kullanılabilir stoğuna göre yeniden hesaplanır.

**Örnek:**\
“Gift Box” = 1 Candle + 1 Soap ise

* Candle = 10 adet
* Soap = 20 adet\
  → Master “Gift Box” envanteri = 10 (en düşük Component miktarına göre).

#### **2.2. “Update Master Inventory”a tıkladığınızda**

Uygulamadaki bu düğmeye tıklayarak Master envanterini istediğiniz zaman manuel olarak yenileyebilirsiniz.\
Bu işlem, Master’ın kullanılabilir miktarını mevcut Component miktarlarından yeniden hesaplar.

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

#### **2.3. Sipariş oluşturuldu**

Bir sipariş Master yerine Component ürünleri içeriyorsa, sistem Master’ın kullanılabilir miktarını yeniden hesaplar.

**Örnek:**\
Bir müşteri 1 Candle satın alırsa (“Gift Box”ın bir Component’i), Candle’ın stoğu düştüğü için “Gift Box” kullanılabilir miktarı da azalır.

#### **2.4. Sipariş iadesi / Sipariş iptali**

Component içeren bir sipariş, Restock açıkken iade edilir veya iptal edilirse Master miktarı buna göre artar.

#### **2.5. Sipariş konumunun değiştirilmesi**

Component ürünlerinin sipariş konumu değiştirildiğinde sistem, Master envanterini yeni ve eski konumlardaki değişikliklere göre ayarlar.

#### **2.6. Sipariş düzenleme**

Sipariş düzenlenirse (ör. miktar değişikliği veya Component ekleme/çıkarma), Master envanteri buna göre yeniden hesaplanır.

***

### Senkronize edilmeyen olaylar

#### 1. Manuel envanter düzenlemeleri

Bir ürünün envanterini doğrudan Shopify yönetici panelinde manuel olarak değiştirirseniz, uygulama bu değişikliği diğer ilgili ürünlere otomatik olarak senkronize etmez.\
**Neden:**&#x20;

* Uygulama dışında yapılan manuel düzenlemeler (ör. Shopify → **Products** → envanteri düzenleme ekranından stok ayarlamak) senkronizasyon olayı olarak kaydedilmez.
* Uygulama yalnızca siparişler, iadeler veya uygulama işlemleri üzerinden yapılan değişiklikleri izler.

**Örnek:**\
Shopify’da “Candle” (“Gift Box”ın bir Component’i) envanterini 10’dan 20’ye manuel olarak artırırsınız.\
→ Uygulama “Gift Box” miktarını otomatik olarak güncellemez.\
Manuel düzenlemelerden sonra Master envanterini yenilemek için uygulamaya gidin ve **“Update Master Inventory”**’ye tıklayın.

#### 2. Üçüncü taraf uygulamalardan gelen güncellemeler

Başka bir uygulama (ör. sevkiyat, depo veya envanter yönetim uygulaması) ürün miktarını değiştirirse, bu Tipo uygulamasında senkronizasyonu tetiklemez.

**Neden**:&#x20;

* Tipo uygulaması envanteri yalnızca belirli Shopify olaylarını (sipariş oluşturma, iade veya düzenleme gibi) algıladığında senkronize eder.\
  \- Üçüncü taraf uygulamalar envanteri, Shopify’ın standart envanter olayı olarak sınıflandırmadığı API’ler veya özel betikler üzerinden güncelleyebilir.

**Örnek:**\
Paketlenip sevk edildiğinde “Soap” stoğunu otomatik olarak azaltan bir depo yönetim uygulaması kullanıyorsunuz.\
→ Tipo Sync bu değişikliği algılamaz ve Master “Gift Box” envanterini ayarlamaz.\
Bu durumda **“Update Master Inventory”**’ye tıklayarak veya paket grubunu yeniden kaydederek senkronizasyonu manuel olarak yenileyebilirsiniz.

#### 3. Taslak siparişler

Shopify’da taslak sipariş oluşturduğunuzda envanter, sipariş gerçekten tamamlanana veya ödenene kadar düşmez.\
Bu nedenle uygulama taslak siparişler için senkronizasyon tetiklemez.

**Neden:**

* Shopify taslak siparişleri “kesinleşmemiş” olarak değerlendirir; yani envanter değişmez.
* Bu aşamada senkronizasyon yapılması hatalı stok seviyelerine yol açabilir.

**Örnek:**\
2 Gift Box için bir taslak sipariş oluşturuyorsunuz ama henüz ödenmiş olarak işaretlemediniz.\
→ Taslak sipariş onaylı bir siparişe dönüşene kadar Tipo, Component’lerin (“Candle” ve “Soap”) envanterini güncellemez.\
Taslak sipariş ödendiğinde veya dönüştürüldüğünde senkronizasyon normal şekilde çalışır.

**🙋 Hâlâ desteğe ihtiyacınız var mı?**

Hâlâ yardıma ihtiyacınız varsa lütfen <hi@tipo.io> adresinden bizimle iletişime geçmekten çekinmeyin. Size memnuniyetle yardımcı olacağız.
