# Sincronizar metacampos

Este guia explica como sincronizar metacampos da sua loja de origem para a sua loja de destino na aplicação Tipo.

### ℹ️ O que são metacampos?

* **Metacampos de produto**
* **Metacampos de variante** (se os ativar)

A aplicação Tipo pode sincronizar metacampos para:

* material, tabela de tamanhos, especificações
* distintivos personalizados (por exemplo, “best\_seller”)
* detalhes adicionais do produto utilizados por temas/aplicações

Os metacampos são campos personalizados do Shopify utilizados para armazenar dados adicionais do produto, tais como:

***

### ✅ **Tipos de metacampo suportados**

* Texto de várias linhas
* Texto formatado
* Número inteiro
* Decimal
* Data e hora
* Data
* Dimensão
* Volume
* Peso
* Verdadeiro ou falso
* Classificação
* URL
* Dinheiro
* Hiperligação
* JSON

🚫 **Ainda não suportado:**\
Os tipos de referência (por exemplo, referência de produto, referência de coleção) não são suportados de momento.

***

### 🛠️ Passo 1: configurar os metacampos na loja de origem

1. Abra a aplicação > clique em **Definições (Settings)** > ative **Partilhar metacampos (Share Metafields)**
2. Escolha o recurso que pretende partilhar:
   * **Recurso de produto (Product resource)** – partilha os metacampos de produto.
   * **Recurso de variante (Variant resource)** – partilha os metacampos de variante.
3. Adicione definições de metacampo específicas para limitar os metacampos que são partilhados.
   * Clique no ícone **Procurar metacampos (Browse metafields)**, ou
   * Introduza a definição do metacampo no formato:

     ```
     namespace.key
     ```

     Por exemplo:

     ```
     custom.materialseo.titlespecifications.weight
     ```
4. Click **Save** to update the changes

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

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

***

### 🛠️ Passo 2: configurar os metacampos na loja de destino

1. Abra a aplicação > clique em **Lojas (Stores)** > clique no URL da loja de origem para abrir os detalhes da ligação

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

2. Ative a **Sincronização de metacampos (Metafields sync)**
3. Escolha o que sincronizar

   Em **Permitir dados (Allow data)**, selecione uma ou ambas as opções:

   * **Recurso de produto (Product Resource)** → sincroniza os metacampos de produto
   * **Recurso de variante (Variant Resource)** → sincroniza os metacampos de variante
4. Clique no ícone de pesquisa à direita para ver todos os metacampos suportados > clique no botão **Selecionar metacampo válido para sincronizar (Select valid metafield to sync)**&#x20;

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

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

5. Clique em **Guardar** para atualizar as alterações

***

### &#x20;🔄 O que acontece durante a sincronização

#### **1) Se a loja de destino não tiver a definição do metacampo**

A aplicação cria automaticamente a definição do metacampo na loja de destino (quando necessário).

Depois de criada, os valores dos metacampos sincronizados aparecem no produto/variante na loja de destino.

#### **2) Se os metacampos existirem mas não estiverem “estruturados” (metacampos não estruturados)**

Em alguns casos, os metacampos podem ser sincronizados mesmo que não tenham sido totalmente definidos/estruturados na loja de destino.

Para os consultar no Shopify Admin:

* **abra** as **Definições da loja → Metacampos e metaobjetos**
* Escolha **Produto** (ou **Variante**)
* Abra **Ver metacampos não estruturados**

💡 Sugestão: pode definir/estruturar manualmente estes metacampos mais tarde para manter os dados da sua loja limpos e consistentes.

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

#### **3) Se a loja de origem não tiver valor, o destino não é substituído**

Se um metacampo existir no destino mas o valor na origem estiver vazio, o Tipo Sync não substitui o valor do destino.

#### **4) Os tipos de dados têm de corresponder (muito importante)**

Os tipos de dados dos metacampos têm de corresponder exatamente entre a origem e o destino.

Exemplos de incompatibilidade de tipos de dados:

* `single_line_text_field` vs `multi_line_text_field`
* `number_integer` vs `number_decimal`
* `product_reference` vs `text`

⚠️ Se os tipos de dados não corresponderem, a sincronização pode falhar ou ignorar esse metacampo.

***

### 📌 Exemplo: sincronizar um metacampo de produto – “Material”

Pretende sincronizar um **metacampo de produto personalizado** chamado **Material** (por exemplo, “Cotton”, “Leather”, “Wool”) da sua **loja de origem** para a sua **loja de destino** através da nossa aplicação.

#### **Passo 1: definir o metacampo no Shopify**

Na sua **loja de origem**:

1. Aceda ao **Shopify Admin >** abra as **Definições** da loja **> Metacampos e metaobjetos** > escolha **Produto** (ou **Variante**)
2. Clique em **Adicionar definição** (se ainda não estiver criada) > preencha a definição do metacampo:
   * **Nome**: Material
   * **Namespace**: `custom`
   * **Chave**: `material`
   * **Tipo**: texto de linha única

\=>  Isto dá-lhe a chave completa do metacampo: `custom.material`

Repita este passo na sua **loja de destino** (a chave e o tipo têm de ser iguais).

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

#### **Passo 2: adicionar dados de metacampo aos produtos**

Na sua **loja de origem**, aceda a um produto e desloque-se para baixo até **Metacampos**  > Em **Material**, introduza: `Cotton`

Este produto passa a ter o metacampo `custom.material = "Cotton"`.

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

#### **Passo 3: configurar a sincronização na aplicação Tipo**&#x20;

* Abra a nossa aplicação na **loja de destino** > aceda a Configuração da ligação **> Sincronização de metacampos**
* Escolha **Metacampos específicos > i**ntroduza exatamente a chave do metacampo: `custom.material`&#x20;

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

**Resultado**

* A nossa aplicação encontra `custom.material` na loja de origem
* Se **não existir** no produto de destino, a aplicação **cria-o**\
  \=>   Resultado: `custom.material = "Cotton"` nas duas lojas
* Se existir no destino mas a origem estiver vazia, **não substituímos** o valor

***

### ❓Perguntas frequentes

#### P1: como definir o `namespace.key` na sua loja?

Para sincronizar um metacampo específico, tem de introduzir a **chave de definição do metacampo** neste formato: `namespace.key` (por exemplo: `custom.color`).

Veja como a encontrar no seu Shopify Admin:

1. Aceda ao seu Shopify Admin > navegue até **Definições > Dados personalizados > Produtos**
2. Clique no metacampo que pretende sincronizar\
   → Vai ver os valores de **Namespace** e **Chave**
3. Combine-os neste formato: `namespace.key`\
   → Exemplo: `custom.description`

#### P2: porque é que os meus metacampos não estão a ser sincronizados?

Se os seus metacampos não estão a ser sincronizados corretamente, pode dever-se a uma das seguintes razões:

1. **A sincronização de metacampos não está ativada**\
   Certifique-se de que a sincronização de metacampos está ativada nas duas lojas:
   * Ative **Partilhar metacampos** na **loja de origem**.
   * Ative **Receber metacampos (Receive Metafields)** na **loja de destino**.

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

2. **A chave de definição do metacampo não foi adicionada**

Além de ativar a sincronização de metacampos, tem também de adicionar a **chave de definição do metacampo (namespace.key)** que pretende sincronizar.

* Aceda a **Definições → Partilhar metacampos**
* Certifique-se de que a opção **Ativar (Enable)** está selecionada
* Em **Permitir dados**, adicione a definição do metacampo neste formato:\
  `namespace.key`\
  Exemplo: `custom.material`&#x20;

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

3. **Tipos de metacampo não suportados**\
   Alguns tipos de dados de metacampo não são suportados, como os **tipos de referência** ou os **metaobjetos**.

Vermelho: metacampos não suportados que não podem ser sincronizados pela aplicação

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

4. **Tipos de metacampo incompatíveis entre lojas**\
   O metacampo na origem e no destino tem de ter **o mesmo tipo de dados e a mesma estrutura**.\
   As incompatibilidades mais comuns incluem:

* Um metacampo é de **texto de linha única**, enquanto o outro é de **texto de várias linhas**.
* Um metacampo utiliza **valor único**, enquanto o outro utiliza **lista de valores**.

Para resolver estes problemas, confirme que os metacampos nas duas lojas têm o mesmo **namespace**, a mesma **chave** e o mesmo **tipo de dados**, e tente sincronizar novamente.

***

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