# Sincronizar produtos com base em identificadores únicos

O app permite sincronizar produtos de uma source store para uma destination store usando um dos seguintes identificadores únicos:

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

Um **identificador único** é um valor do produto que é igual nas duas lojas e pode ser usado para associar os produtos corretamente.

Depois que os produtos são associados, o app Tipo pode sincronizar atualizações (preço, título, imagens etc.) com base nas suas configurações.

### ✅ Qual identificador devo usar?

#### 1. Handle (recomendado)

**O que é:**\
O handle é uma string única usada na URL de cada produto. Ele é 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 na source store tiver o mesmo handle de um produto na destination store, o app considera que são o mesmo produto e sincroniza os dados.

**Exemplo:**

| Source Store                | Destination Store           |
| --------------------------- | --------------------------- |
| Product Title: "Red Shirt"  | Product Title: "Red Shirt"  |
| Handle: `red-shirt`         | Handle: `red-shirt`         |

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

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

***

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

**O que é:**\
O SKU é um código que você atribui a cada variante de produto para controlar o estoque.

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

**Lógica de sincronização:**\
O app associará as variantes de produto com base no mesmo SKU nas duas lojas.

**Exemplo:**

| Source Store                     | Destination Store                |
| -------------------------------- | -------------------------------- |
| Product: "Sneakers"              | Product: "Sneakers"              |
| Variant: Size 42 - SKU: `SNK-42` | Variant: Size 42 - SKU: `SNK-42` |

Esta variante será sincronizada porque os SKUs coincidem.

❗**Atenção:** se vários produtos compartilharem o mesmo SKU entre variantes, isso pode levar a associações incorretas.

***

#### 3. Código de barras

**O que é:**\
O **código de barras** é um identificador de produto globalmente único, geralmente usado em sistemas de leitura no varejo.

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

**Lógica de sincronização:**\
O app associará as **variantes de produto** com base no campo de código de barras no Shopify.

**Exemplo:**

| Source Store                              | Destination Store                         |
| ----------------------------------------- | ----------------------------------------- |
| Product: "Water Bottle"                   | Product: "Water Bottle"                   |
| Variant: 500ml - Barcode: `1234567890123` | Variant: 500ml - Barcode: `1234567890123` |

Este produto será sincronizado corretamente usando o código de barras.

❗**Observação:**&#x20;

Use esta opção somente se todas as variantes em todas as lojas tiverem códigos de barras exclusivos.

***

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

#### **Para uma nova conexão:**

Antes de conectar, verifique e selecione as informações de produtos que deseja sincronizar [aqui](/product-syncs/select-products-to-sync).

1\. Abra o app na loja **Destination** > clique em **Stores** > clique no botão **Connect store**

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

2\. Digite o **Connection Code** obtido na Source Store (encontrado em Settings do app na Source Store).​

3\. Na seção **General** > **Matching & Imports**, selecione **Create new items if not exist and update current items that have the same handle**

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

4\. Ative a configuração **Product sync** > selecione **Unique Identifier** para sincronizar produtos com base nele

Por exemplo: se o handle for selecionado, os produtos com 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. Salve para iniciar a conexão

#### **Para uma conexão em andamento**

1\. Acesse a loja **Destinations** > clique em **Stores** > clique na URL da loja de origem para ver os detalhes da conexão

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

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

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

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

***

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

🧪 Exemplo (correspondência por handle)

**Produto na source store**

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

**Destination store**

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

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

Quando a sincronização é executada:

1. O Tipo Sync lê os produtos da Source store
2. Ele procura na Destination store um produto com o mesmo identificador
3. Em seguida, 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 permitir)

***

### 🌟 Boas práticas

* **Use Handle** se as estruturas dos produtos forem idênticas entre as lojas.
* **Use SKU** somente se todas as variantes tiverem um **SKU exclusivo**.
* **Use Código de barras** em ambientes de varejo onde os códigos de barras são usados de forma consistente.

***

**🙋 Ainda precisa de suporte?**

Se ainda precisar de ajuda, entre em contato conosco pelo e-mail <hi@tipo.io>. Teremos prazer em ajudar você.
