# Eventos de sincronização em grupos de sincronização de inventário

Este guia explica o que são os **eventos de sincronização (Sync Events)** e como mantêm os seus **grupos de sincronização de inventário (Inventory Sync Groups)** atualizados automaticamente.

## ℹ️  O que são eventos de sincronização?

Um **evento de sincronização** é uma ação que altera o inventário no Shopify e leva o Tipo a atualizar os outros produtos do mesmo grupo de sincronização de inventário.

Em termos simples:

> **Algo altera o stock → o Tipo deteta → o Tipo sincroniza o grupo.**

***

## 🔄 Como acontece a sincronização (eventos de sincronização)

Sempre que ocorre um dos eventos abaixo, o Tipo cria um **evento de sincronização** e atualiza o inventário dos produtos do **grupo de sincronização de inventário** correspondente.\
Estes são os principais eventos que podem desencadear a sincronização:

### 🧩 1) Grupo criado ou atualizado

Sempre que um grupo é criado ou atualizado, a aplicação sincroniza automaticamente o inventário de acordo com a configuração desse grupo.&#x20;

**Quando é desencadeado**

**a) Grupo criado/editado:** Cria um novo grupo ou atualiza as definições/variantes do grupo

**b) Atualização em massa:** Atualiza vários grupos através do editor em massa

**c) Importação:** Importa grupos através de CSV

**O que acontece**

O Tipo recalcula o inventário do grupo com base nas novas definições e, em seguida, atualiza todos os artigos associados.

**Exemplo:**\
Cria um grupo que associa a T-shirt vermelha e a T-shirt azul porque partilham o mesmo stock.\
Depois de clicar em **Guardar**, o Tipo Sync desencadeia um evento de sincronização de grupo criado/atualizado e recalcula o inventário do grupo.\
Por exemplo, se o inventário for de 100 unidades, o Tipo Sync define:

* T-shirt vermelha = 100
* T-shirt azul = 100

***

### 🛒 2) Encomenda criada

**Quando é desencadeado**

Este evento acontece quando um cliente faz uma encomenda de um produto de um grupo de sincronização.

**O que acontece**

O Shopify reduz o inventário → o Tipo atualiza o resto do grupo para manter o inventário consistente.

**Exemplo:**

O seu grupo associa a T-shirt vermelha e a T-shirt azul, e ambas mostram 100 unidades.\
Um cliente compra 3 T-shirts azuis.\
O Tipo Sync deteta a alteração de inventário e atualiza o grupo:

* T-shirt azul = 97
* T-shirt vermelha = 97

### &#x20;↩️ 3) Encomenda reembolsada ou cancelada

**Quando é desencadeado**

Este evento acontece quando uma encomenda é reembolsada/cancelada e o inventário volta a ser colocado em stock (com base nas definições do Shopify).

**O que acontece**

O inventário aumenta no Shopify → o Tipo sincroniza a nova quantidade com os outros artigos do grupo.

**Nota**: Apenas os artigos com “Repor em stock” assinalado no Shopify serão sincronizados novamente com o inventário disponível.

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

**Exemplo:**<br>

Após a venda, ambas as camisas mostram **97 unidades**.\
Reembolsa **2** artigos e repõe o inventário em stock.\
O Tipo Sync sincroniza o grupo:

* T-shirt vermelha = 99
* T-shirt azul = 99

***

### 📍4)  Localização da encomenda alterada

**Quando é desencadeado**

Este evento acontece quando a localização de processamento/inventário de um artigo da encomenda é alterada (para lojas que utilizam várias localizações).

**O que acontece**

O Tipo recalcula o inventário com base na localização atualizada e atualiza os artigos do grupo em conformidade.

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

**Exemplo:**\
Uma venda foi inicialmente deduzida do **Armazém A** e, depois, a localização da encomenda é alterada para o **Armazém B**.\
A aplicação Tipo recalcula o inventário com base na nova localização e atualiza os artigos do grupo utilizando o stock disponível dessa localização.

***

### ✏️ 5) Encomenda editada

**Quando é desencadeado**

Este evento acontece quando as linhas de artigos da encomenda são alteradas depois de a encomenda ser criada.&#x20;

Inclui:

**a. Adicionar novo produto:** O produto recém-adicionado é sincronizado e o respetivo stock é reduzido.

**b. Atualizar quantidade:** A aplicação ajusta o inventário para refletir a quantidade de produto atualizada na encomenda.

**O que acontece**

O Shopify ajusta novamente o inventário → o Tipo aplica o inventário atualizado a todo o grupo.

**Exemplo:**\
Um cliente encomendou inicialmente **1** unidade e, depois, edita a encomenda para **3** unidades.\
O Shopify ajusta novamente o inventário e o Tipo Sync atualiza o grupo para que todos os artigos associados correspondam ao novo nível de inventário.

***

### Resumo

| Tipo de evento                | Desencadeador                                       | Ação executada                                                      | Exemplo                                                    |
| ----------------------------- | --------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------- |
| **Grupo criado / atualizado** | Grupo criado, editado, atualizado em massa ou importado | Recalcula e sincroniza o inventário de todas as variantes do grupo | Associa a T-shirt vermelha e azul → ambas atualizadas para o mesmo stock |
| **Encomenda criada**          | Nova encomenda efetuada                             | Deduz a quantidade encomendada em todas as variantes associadas     | 1 vermelha vendida → 1 azul também deduzida                |
| **Encomenda reembolsada / cancelada** | Reembolso ou cancelamento com “Repor artigos em stock” assinalado | Repõe em stock a quantidade do produto no grupo   | 1 vermelha reembolsada → 1 azul também reposta em stock    |
| **Localização da encomenda alterada** | Encomenda movida para outra localização de processamento | Ajusta o stock nas localizações antiga e nova                 | Mudança do Armazém A → B → stock ajustado                  |
| **Encomenda editada**         | Encomenda modificada                                | Atualiza o inventário quando são adicionados novos produtos ou alteradas quantidades | Adicionada mais 1 vermelha → 1 azul também reduzida |

**🙋 Ainda precisa de ajuda?**

Se ainda precisar de ajuda, não hesite em contactar-nos através de <hi@tipo.io>. Teremos todo o gosto em ajudá-lo(a).
