# Desencadenantes de sincronización entre productos maestros y componentes

Esta guía explica qué acciones desencadenan la sincronización en los grupos de paquetes y qué actualiza la aplicación Tipo entre el producto maestro (paquete) y sus productos componentes.

## ✅ ¿Qué son los “desencadenantes de sincronización (sync triggers)”?

Un **desencadenante de sincronización** es un evento que cambia el inventario en Shopify y hace que Tipo Sync vuelva a calcular el paquete.

En pocas palabras:

> **Algo cambia el stock → Tipo lo detecta → actualiza el producto maestro y/o los componentes**

***

## 🧩 Cómo funciona la sincronización

### 1. Sincronización de productos maestros → componentes

Cuando se produce un cambio en el producto **maestro**, el sistema actualiza los productos **componentes** en consecuencia.

Esto garantiza que, cuando se vende un **producto maestro**, también se descuenten sus **componentes**.

#### 1.1. Pedido creado (Order Created)

Cuando un pedido incluye un producto maestro, se resta la cantidad correspondiente de cada producto componente.

**Ejemplo:**\
Si un paquete maestro “Caja de regalo” incluye:

* 1 vela
* 1 jabón

Cuando un cliente pide **2 cajas de regalo**, el sistema descontará automáticamente **2 velas** y **2 jabones** del inventario.

#### **1.2. Reembolso / cancelación de pedido (Order Refund / Order Cancel)**

Si se reembolsa o cancela un pedido que contiene un producto maestro y la opción **Reponer en inventario (Restock)** está activada, las cantidades de los componentes se restauran en consecuencia.

**Ejemplo:**\
Si se reembolsó 1 “Caja de regalo” con reposición activada, las cantidades de vela y jabón aumentan en 1.

#### **1.3. Cambio de ubicación del pedido (Order change Location)**

Si se cambia la ubicación de un pedido, el sistema actualiza el inventario tanto en la ubicación anterior como en la nueva para garantizar la coherencia.

**Ejemplo:**\
Si un pedido pasa del almacén A al almacén B, el inventario de los componentes en el almacén A aumenta y el del almacén B disminuye.

#### **1.4. Edición de pedido (Order Edit)**

Si se edita el pedido que contiene productos maestros:

* **Agregar nuevos productos:** las cantidades de los componentes se ajustan en consecuencia.
* **Actualizar cantidades de productos:** las cantidades de los componentes se recalculan según la nueva cantidad del pedido.

**Ejemplo:**\
Si el pedido tenía originalmente 1 caja de regalo y se actualiza a 2, el inventario de los componentes se reducirá 1 unidad más de cada uno.

***

### **2. Sincronización de componentes → productos maestros**

Esta dirección se aplica cuando se activa la configuración **“Sincronizar componente con maestro (Sync Component to Master)”**.\
Garantiza que, cuando cambian las cantidades de los componentes, la cantidad del producto maestro relacionado se actualice automáticamente.

#### **2.1. Al crear o actualizar un paquete (When Creating or Updating a Bundle)**

Cuando se crea o edita un grupo de paquetes, el inventario del producto maestro se recalcula según el stock disponible de todos los componentes.

**Ejemplo:**\
Si “Caja de regalo” = 1 vela + 1 jabón

* Vela = 10 unidades
* Jabón = 20 unidades\
  → Inventario del producto maestro “Caja de regalo” = 10 (según la cantidad más baja de los componentes).

#### **2.2. Al hacer clic en «Actualizar inventario del maestro» (When clicking “Update Master Inventory”)**

Puede actualizar manualmente el inventario del producto maestro en cualquier momento haciendo clic en este botón de la aplicación.\
Esto recalcula la cantidad disponible del producto maestro a partir de las cantidades actuales de los componentes.

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

#### **2.3. Pedido creado (Order created)**

Si un pedido incluye productos componentes (en lugar del maestro), el sistema recalcula la cantidad disponible del producto maestro.

**Ejemplo:**\
Si un cliente compra 1 vela (un componente de “Caja de regalo”), la cantidad disponible de “Caja de regalo” también disminuirá, ya que uno de sus componentes ahora tiene menos stock.

#### **2.4. Reembolso / cancelación de pedido (Order refund / Order cancel)**

Cuando se reembolsa o cancela un pedido que contiene componentes con reposición activada, la cantidad del producto maestro aumenta en consecuencia.

#### **2.5. Cambio de ubicación del pedido (Order change Location)**

Cuando se cambia la ubicación del pedido de los productos componentes, el sistema ajusta el inventario del producto maestro para reflejar los cambios en la ubicación nueva y en la anterior.

#### **2.6. Edición de pedido (Order edit)**

Si se edita el pedido (por ejemplo, al cambiar la cantidad o agregar o quitar un componente), el inventario del producto maestro se recalcula en consecuencia.

***

### Eventos no sincronizados

#### 1. Ediciones manuales de inventario

Si cambia manualmente el inventario de un producto directamente en su panel de administración de Shopify, la aplicación no sincronizará automáticamente este cambio con otros productos relacionados.\
**Motivo:**

* Las ediciones manuales realizadas fuera de la aplicación (p. ej., ajustar el stock en Shopify → **Productos (Products)** → Editar inventario) no se registran como eventos de sincronización.
* La aplicación solo rastrea los cambios realizados mediante pedidos, reembolsos o acciones de la aplicación.

**Ejemplo:**\
Aumenta manualmente el inventario de “Vela” (un componente de “Caja de regalo”) de 10 → 20 en Shopify.\
→ La aplicación no actualizará automáticamente la cantidad de “Caja de regalo”.\
Para actualizar el inventario del producto maestro tras ediciones manuales, vaya a la aplicación y haga clic en **“Actualizar inventario del maestro”**.

#### 2. Actualizaciones de aplicaciones de terceros

Si otra aplicación (como una de cumplimiento de pedidos, almacén o gestión de inventario) cambia la cantidad de un producto, esto no desencadenará la sincronización en la aplicación Tipo.

**Motivo**:

* La aplicación Tipo solo sincroniza el inventario cuando detecta eventos específicos de Shopify (como la creación, el reembolso o la edición de un pedido).\
  \- Las aplicaciones de terceros pueden actualizar el inventario mediante API o scripts personalizados que Shopify no clasifica como eventos de inventario estándar.

**Ejemplo:**\
Usa una aplicación de gestión de almacén que disminuye automáticamente el stock de “Jabón” cuando se empaqueta para el envío.\
→ Tipo Sync no detectará este cambio y no ajustará el inventario del producto maestro “Caja de regalo”.\
En este caso, puede actualizar la sincronización manualmente haciendo clic en **“Actualizar inventario del maestro”** o volviendo a guardar el grupo de paquetes.

#### 3. Pedidos en borrador (Draft Orders)

Cuando crea pedidos en borrador en Shopify, el inventario no se reduce hasta que el pedido se completa o se paga realmente.\
Por lo tanto, la aplicación no desencadena la sincronización de inventario para los pedidos en borrador.

**Motivo:**

* Shopify trata los pedidos en borrador como “no finalizados”, por lo que el inventario permanece sin cambios.
* Sincronizar en esta etapa podría generar niveles de stock inexactos.

**Ejemplo:**\
Crea un pedido en borrador de 2 cajas de regalo, pero todavía no lo ha marcado como pagado.\
→ Tipo no actualiza el inventario de los componentes (“Vela” y “Jabón”) hasta que el pedido en borrador se convierta en un pedido confirmado.\
Una vez que el pedido en borrador se pague o se convierta, la sincronización se ejecutará con normalidad.

**🙋 ¿Necesita más ayuda?**

Si todavía necesita ayuda, escríbanos a <hi@tipo.io>. Estaremos encantados de ayudarle.
