# Sincronizar produtos com base em identificadores únicos

A aplicação permite-lhe sincronizar produtos de uma loja de origem para uma loja de destino utilizando um dos seguintes identificadores únicos:

* **Handle** (recomendado)
* **SKU**
* **Código de barras (Barcode)**

Um **identificador único** é um valor de produto que é igual nas duas lojas e pode ser utilizado para fazer corresponder os produtos corretamente.

Depois de os produtos estarem associados, a aplicação Tipo pode sincronizar atualizações (preço, título, imagens, etc.) com base nas suas definições.

### ✅ Que identificador devo utilizar?

#### 1. Handle (recomendado)

**O que é:**\
O handle é uma cadeia de caracteres única utilizada no URL de cada produto. É gerado automaticamente a partir do título do produto, mas pode ser editado manualmente no Shopify.

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

**Lógica de sincronização:**\
Se um produto da loja de origem tiver o mesmo handle que um produto da loja de destino, a aplicação considera-os o mesmo produto e sincroniza os dados.

**Exemplo:**

| Loja de origem               | Loja de destino          |
| -------------------------- | -------------------------- |
| Título do produto: "Red Shirt" | Título do produto: "Red Shirt" |
| Handle: `red-shirt`        | Handle: `red-shirt`        |

Este produto **será sincronizado corretamente** porque os handles correspondem.

❗**Sugestão:** utilize sempre a sincronização por handle se as suas lojas tiverem estruturas de produtos idênticas.

***

#### 2. SKU (Stock Keeping Unit)

**O que é:**\
O SKU é um código que atribui a cada variante de produto para controlar o inventário.

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

**Lógica de sincronização:**\
A aplicação faz corresponder as variantes de produto com base no mesmo SKU nas duas lojas.

**Exemplo:**

| Loja de origem                     | Loja de destino                |
| -------------------------------- | -------------------------------- |
| Produto: "Sneakers"              | Produto: "Sneakers"              |
| Variante: Size 42 - SKU: `SNK-42` | Variante: Size 42 - SKU: `SNK-42` |

Esta variante será sincronizada porque os SKU correspondem.

❗**Aviso:** se vários produtos partilharem o mesmo SKU entre variantes, pode ocorrer uma correspondência incorreta.

***

#### 3. Código de barras

**O que é:**\
O **código de barras** é um identificador de produto globalmente único, normalmente utilizado em sistemas de leitura no retalho.

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

**Lógica de sincronização:**\
A aplicação faz corresponder as **variantes de produto** com base no campo de código de barras do Shopify.

**Exemplo:**

| Loja de origem                              | Loja de destino                         |
| ----------------------------------------- | ----------------------------------------- |
| Produto: "Water Bottle"                   | Produto: "Water Bottle"                   |
| Variante: 500ml - Código de barras: `1234567890123` | Variante: 500ml - Código de barras: `1234567890123` |

Este produto será sincronizado corretamente através do código de barras.

❗**Nota:**&#x20;

Utilize esta opção apenas se todas as variantes das várias lojas tiverem códigos de barras únicos.

***

### ⚙️ **Passos para selecionar os identificadores**

#### **Para uma nova ligação:**

Antes de estabelecer a ligação, verifique e selecione as informações de produto que pretende sincronizar [aqui](/product-syncs/select-products-to-sync).

1\. Abra a aplicação na loja de **destino** > clique em **Lojas (Stores)** > clique no botão **Ligar loja (Connect store)**

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

2\. Introduza o **Código de ligação (Connection Code)** obtido na loja de origem (encontra-o nas Definições da aplicação na loja de origem).​

3\. Em **Geral (General)** > secção **Correspondência e importações (Matching & Imports)** > selecione **Criar novos artigos se não existirem e atualizar os artigos existentes que tenham o mesmo handle**

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

4\. Ative a definição **Sincronização de produtos (Product sync)** > selecione **Identificador único (Unique Identifier)** para sincronizar os produtos com base nele

Por exemplo: se o handle for selecionado, os produtos que tenham o mesmo handle serão sincronizados entre as lojas.&#x20;

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

5. Guarde para iniciar a ligação

#### **Para uma ligação em execução**

1\. Aceda à loja **de destino** > clique em **Lojas** > clique no URL da loja de origem para ver os detalhes da ligação

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

2\. Selecione um identificador único para sincronizar os produtos com base nele

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

3. Clique em **Guardar (Save)** para aplicar as alterações.

***

### 🔄 O que acontece durante a sincronização?

🧪 Exemplo (correspondência por handle)

**Produto da loja de origem**

* Produto: Ceramic Table Lamp
* Handle: `ceramic-table-lamp`

**Loja de destino**

* Se existir um produto com o handle `ceramic-table-lamp` → é atualizado
* Se não existir → é importado (se estiver ativado)

**⚙️ Como funciona a correspondência durante a sincronização**

Quando a sincronização é executada:

1. O Tipo Sync lê os produtos da loja de origem
2. Procura na loja de destino um produto com o mesmo identificador
3. Depois decide:
   * &#x20;**Correspondência encontrada** → atualiza os campos do produto existente (com base nas suas seleções de sincronização)
   * &#x20;**Nenhuma correspondência encontrada** → importa/cria um novo produto (se o seu modo de importação o permitir)

***

### 🌟 Boas práticas

* **Utilize o handle** se as estruturas de produtos forem idênticas entre as lojas.
* **Utilize o SKU** apenas se cada variante tiver um **SKU único**.
* **Utilize o código de barras** em ambientes de retalho em que os códigos de barras sejam utilizados de forma consistente.

***

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