# Acionadores de sincronização entre Produtos principais e Produtos componentes

Este guia explica que ações acionam a sincronização nos Grupos de pacotes e o que a aplicação Tipo atualiza entre o Produto principal (pacote) e os seus Produtos componentes.

## ✅ O que são "acionadores de sincronização"?

Um **acionador de sincronização** é um evento que altera o inventário no Shopify e leva a Sincronização Tipo a recalcular o pacote.

Em termos simples:

> **Algo altera o stock → a Tipo deteta-o → atualiza o Principal e/ou os Componentes**

***

## 🧩 Como funciona a sincronização

### 1. Sincronização de Principal → Produtos componentes

Quando ocorre uma alteração no produto **Principal**, o sistema atualiza os produtos **Componentes** em conformidade.

Isto garante que, quando um **Principal** é vendido, os seus **Componentes** também são deduzidos.

#### 1.1. Encomenda criada

Quando uma encomenda inclui um produto Principal, a quantidade correspondente de cada produto Componente é subtraída.

**Exemplo:**\
Se um pacote Principal "Caixa de oferta" incluir:

* 1 Vela
* 1 Sabonete

Quando um cliente encomendar **2 Caixas de oferta**, o sistema deduz automaticamente **2 Velas** e **2 Sabonetes** do inventário.

#### **1.2. Reembolso / cancelamento de encomenda**

Se uma encomenda que contém um produto Principal for reembolsada ou cancelada e a opção **Repor em stock (Restock)** estiver ativada, as quantidades dos Componentes são repostas em conformidade.

**Exemplo:**\
Se 1 "Caixa de oferta" for reembolsada com reposição em stock ativada, as quantidades da Vela e do Sabonete aumentam ambas em 1.

#### **1.3. Alteração de localização da encomenda**

Se a localização de uma encomenda for alterada, o sistema atualiza o inventário tanto na localização antiga como na nova para garantir a consistência.

**Exemplo:**\
Se uma encomenda passar do Armazém A para o Armazém B, o inventário dos Componentes no Armazém A aumenta e o inventário no Armazém B diminui.

#### **1.4. Edição da encomenda**

Se a encomenda que contém produtos Principais for editada:

* **Adicionar novos produtos:** as quantidades dos Componentes são ajustadas em conformidade.
* **Atualizar as quantidades dos produtos:** as quantidades dos Componentes são recalculadas com base na nova quantidade da encomenda.

**Exemplo:**\
Se a encomenda tinha originalmente 1 Caixa de oferta e for atualizada para 2, o inventário dos Componentes é reduzido em mais 1 cada.

***

### **2. Sincronização de Componentes → Produtos principais**

Esta direção aplica-se quando ativa a definição **"Sincronizar Componente com Principal (Sync Component to Master)"**.\
Garante que, quando as quantidades dos Componentes se alteram, a quantidade do Principal relacionado é atualizada automaticamente.

#### **2.1. Ao criar ou atualizar um pacote**

Quando cria ou edita um Grupo de pacotes, o inventário do Principal é recalculado com base no stock disponível de todos os Componentes.

**Exemplo:**\
Se "Caixa de oferta" = 1 Vela + 1 Sabonete

* Vela = 10 unidades
* Sabonete = 20 unidades\
  → Inventário do Principal "Caixa de oferta" = 10 (com base na menor quantidade de Componente).

#### **2.2. Ao clicar em "Atualizar inventário do Principal (Update Master Inventory)"**

Pode atualizar manualmente o inventário do Principal em qualquer altura clicando neste botão na aplicação.\
Isto recalcula a quantidade disponível do Principal a partir das quantidades atuais dos Componentes.

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

#### **2.3. Encomenda criada**

Se uma encomenda incluir produtos Componentes (em vez do Principal), o sistema recalcula a quantidade disponível do Principal.

**Exemplo:**\
Se um cliente comprar 1 Vela (um Componente da "Caixa de oferta"), a quantidade disponível da "Caixa de oferta" também diminui, uma vez que um dos seus Componentes tem agora menos stock.

#### **2.4. Reembolso / cancelamento de encomenda**

Quando uma encomenda que contém Componentes é reembolsada ou cancelada com a reposição em stock ativada, a quantidade do Principal aumenta em conformidade.

#### **2.5. Alteração de localização da encomenda**

Quando a localização da encomenda de produtos Componentes é alterada, o sistema ajusta o inventário do Principal para refletir as alterações na localização nova e na antiga.

#### **2.6. Edição da encomenda**

Se a encomenda for editada (p. ex., alterar a quantidade ou adicionar/remover um Componente), o inventário do Principal é recalculado em conformidade.

***

### Eventos não sincronizados

#### 1. Edições manuais de inventário

Se alterar manualmente o inventário de um produto diretamente no Shopify Admin, a aplicação não sincroniza automaticamente esta alteração com outros produtos relacionados.\
**Motivo:**

* As edições manuais feitas fora da aplicação (p. ex., ajustar o stock no Shopify → **Produtos** → Editar inventário) não são registadas como eventos de sincronização.
* A aplicação só acompanha as alterações feitas através de encomendas, reembolsos ou ações da aplicação.

**Exemplo:**\
Aumenta manualmente o inventário da "Vela" (um Componente da "Caixa de oferta") de 10 → 20 no Shopify.\
→ A aplicação não atualiza automaticamente a quantidade da "Caixa de oferta".\
Para atualizar o inventário do Principal após edições manuais, aceda à aplicação e clique em **"Atualizar inventário do Principal"**.

#### 2. Atualizações de aplicações de terceiros

Se outra aplicação (como uma aplicação de processamento de encomendas, de armazém ou de gestão de inventário) alterar a quantidade de um produto, isso não aciona a sincronização na aplicação Tipo.

**Motivo**:

* A aplicação Tipo só sincroniza o inventário quando deteta eventos específicos do Shopify (como criação, reembolso ou edição de encomendas).\
  \- As aplicações de terceiros podem atualizar o inventário através da API ou de scripts personalizados que o Shopify não classifica como eventos de inventário normais.

**Exemplo:**\
Utiliza uma aplicação de gestão de armazém que diminui automaticamente o stock do "Sabonete" quando este é embalado para expedição.\
→ A Sincronização Tipo não deteta esta alteração e não ajusta o inventário da "Caixa de oferta" Principal.\
Neste caso, pode atualizar manualmente a sincronização clicando em **"Atualizar inventário do Principal"** ou guardando novamente o grupo de pacotes.

#### 3. Rascunhos de encomendas

Quando cria rascunhos de encomendas no Shopify, o inventário não é reduzido até a encomenda ser efetivamente concluída ou paga.\
Por isso, a aplicação não aciona a sincronização de inventário para rascunhos de encomendas.

**Motivo:**

* O Shopify trata os rascunhos de encomendas como "não finalizados", o que significa que o inventário permanece inalterado.
* Sincronizar nesta fase poderia causar níveis de stock incorretos.

**Exemplo:**\
Cria um rascunho de encomenda para 2 Caixas de oferta, mas ainda não o marcou como pago.\
→ A Tipo não atualiza o inventário dos Componentes ("Vela" e "Sabonete") até o rascunho se tornar uma encomenda confirmada.\
Quando o rascunho for pago ou convertido, a sincronização é executada normalmente.

**🙋 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).
