# Eventos de sincronización en grupos de sincronización de inventario

Esta guía explica qué son los **eventos de sincronización (Sync Events)** y cómo mantienen actualizados sus **grupos de sincronización de inventario** de forma automática.

## ℹ️  ¿Qué son los eventos de sincronización?

Un **evento de sincronización** es una acción que cambia el inventario en Shopify y hace que Tipo actualice los demás productos del mismo grupo de sincronización de inventario.

En pocas palabras:

> **Algo cambia el stock → Tipo lo detecta → Tipo sincroniza el grupo.**

***

## 🔄 Cómo ocurre la sincronización (eventos de sincronización)

Cada vez que ocurre uno de los eventos siguientes, Tipo crea un **evento de sincronización** y actualiza el inventario de los productos del **grupo de sincronización de inventario** relacionado.\
Estos son los principales eventos que pueden desencadenar la sincronización:

### 🧩 1) Grupo creado o actualizado (Group created or updated)

Siempre que se crea o actualiza un grupo, la aplicación sincroniza automáticamente el inventario según la configuración de ese grupo.

**Cuándo se desencadena**

**a) Grupo creado/editado (Group created/edited):** crea un grupo nuevo o actualiza los ajustes o variantes del grupo

**b) Actualización masiva (Bulk update):** actualiza varios grupos con el editor masivo

**c) Importación (Import):** importa grupos mediante CSV

**Qué sucede**

Tipo recalcula el inventario del grupo según la nueva configuración y luego actualiza todos los artículos vinculados.

**Ejemplo:**\
Crea un grupo que vincula Camiseta roja y Camiseta azul porque comparten el mismo stock.\
Después de hacer clic en **Guardar (Save)**, Tipo Sync desencadena un evento de sincronización de grupo creado/actualizado y recalcula el inventario del grupo.\
Por ejemplo, si el inventario es de 100 unidades, Tipo Sync establece:

* Camiseta roja = 100
* Camiseta azul = 100

***

### 🛒 2) Pedido creado (Order created)

**Cuándo se desencadena**

Este evento ocurre cuando un cliente realiza un pedido de un producto de un grupo de sincronización.

**Qué sucede**

Shopify reduce el inventario → Tipo actualiza el resto del grupo para mantener el inventario coherente.

**Ejemplo:**

Su grupo vincula Camiseta roja y Camiseta azul, y ambas muestran 100 unidades.\
Un cliente compra 3 de Camiseta azul.\
Tipo Sync detecta el cambio de inventario y actualiza el grupo:

* Camiseta azul = 97
* Camiseta roja = 97

### ↩️ 3) Pedido reembolsado o cancelado (Order refunded or canceled)

**Cuándo se desencadena**

Este evento ocurre cuando se reembolsa o cancela un pedido y el inventario se devuelve al stock (según los ajustes de Shopify).

**Qué sucede**

El inventario aumenta en Shopify → Tipo sincroniza la nueva cantidad con los demás artículos del grupo.

**Nota**: solo los artículos con “Reponer en inventario (Restock)” marcado en Shopify se sincronizarán de nuevo con el inventario disponible.

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

**Ejemplo:**<br>
Después de la venta, ambas camisetas muestran **97 unidades**.\
Reembolsa **2** artículos y devuelve el inventario al stock.\
Tipo Sync sincroniza el grupo:

Tras la venta, ambas camisetas muestran **97 unidades**.\
Reembolsas **2** artículos y devuelves el inventario al stock.\
Tipo Sync sincroniza el grupo:

* Camiseta roja = 99
* Camiseta azul = 99

***

### 📍4)  Ubicación del pedido modificada (Order location changed)

**Cuándo se desencadena**

Este evento ocurre cuando cambia la ubicación de cumplimiento o de inventario de un artículo del pedido (para tiendas que usan varias ubicaciones).

**Qué sucede**

Tipo recalcula el inventario según la ubicación actualizada y actualiza los artículos del grupo en consecuencia.

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

**Ejemplo:**\
Una venta se descontó originalmente del **almacén A** y luego la ubicación del pedido se cambia al **almacén B**.\
La aplicación Tipo recalcula el inventario según la nueva ubicación y actualiza los artículos del grupo con el stock disponible de esa ubicación.

***

### ✏️ 5) Pedido editado (Order edited)

**Cuándo se desencadena**

Este evento ocurre cuando se modifican las líneas del pedido después de crearlo.

Incluye:

**a. Agregar producto nuevo (Add New Product):** el producto recién agregado se sincroniza y su stock se reduce.

**b. Actualizar cantidad (Update Quantity):** la aplicación ajusta el inventario para reflejar la cantidad actualizada del producto en el pedido.

**Qué sucede**

Shopify vuelve a ajustar el inventario → Tipo aplica el inventario actualizado en todo el grupo.

**Ejemplo:**\
Un cliente pidió originalmente **1** unidad y luego edita el pedido a **3** unidades.\
Shopify vuelve a ajustar el inventario y Tipo Sync actualiza el grupo para que todos los artículos vinculados coincidan con el nuevo nivel de inventario.

***

### Resumen

| Tipo de evento                | Desencadenante                                      | Acción realizada                                                    | Ejemplo                                                    |
| ----------------------------- | --------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------- |
| **Grupo creado / actualizado**   | Grupo creado, editado, actualizado en bloque o importado | Recalcula y sincroniza el inventario de todas las variantes del grupo | Vincula Camiseta roja y azul → ambas se actualizan al mismo stock |
| **Pedido creado**             | Se realiza un nuevo pedido                          | Descuenta la cantidad pedida en todas las variantes vinculadas      | 1 roja vendida → también se descuenta 1 azul                |
| **Pedido reembolsado / cancelado** | Reembolso o cancelación con “Reponer artículos en inventario” marcado | Repone la cantidad del producto en el grupo                         | 1 roja reembolsada → también se repone 1 azul               |
| **Ubicación del pedido modificada**    | El pedido pasa a otra ubicación de cumplimiento     | Ajusta el stock en la ubicación anterior y en la nueva              | Cambio de almacén A → B → stock ajustado                 |
| **Pedido editado**              | Pedido modificado                                   | Actualiza el inventario cuando se agregan productos nuevos o cambian las cantidades | Se agrega 1 roja más → también se reduce 1 azul             |

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

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