# Sincronizar metafields

Esta guía explica cómo sincronizar metafields de su tienda de origen a su tienda de destino en la aplicación Tipo.

### ℹ️ ¿Qué son los metafields?

* **Metafields de producto**
* **Metafields de variante** (si los habilitas)

La aplicación Tipo puede sincronizar metafields para:

* material, guía de tallas, especificaciones
* insignias personalizadas (p. ej., “best\_seller”)
* detalles adicionales del producto que usan los temas o las aplicaciones

Los metafields son campos personalizados de Shopify que se usan para almacenar datos adicionales del producto, como:

***

### ✅ **Tipos de metafield compatibles**

* Texto de varias líneas (Multi-line text)
* Texto enriquecido (Rich text)
* Entero (Integer)
* Decimal
* Fecha y hora (Date and time)
* Fecha (Date)
* Dimensión (Dimension)
* Volumen (Volume)
* Peso (Weight)
* Verdadero o falso (True or false)
* Valoración (Rating)
* URL
* Dinero (Money)
* Enlace (Link)
* JSON

🚫 **Aún no compatibles:**\
Los tipos de referencia (p. ej., referencia de producto, referencia de colección) todavía no son compatibles.

***

### 🛠️ Paso 1: configure los metafields en la tienda de origen

1. Abra la aplicación > haga clic en **Configuración (Settings)** > active **Compartir metafields (Share Metafields)**
2. Elija el recurso que desea compartir:
   * **Recurso de producto (Product resource)** – Comparte metafields de producto.
   * **Recurso de variante (Variant resource)** – Comparte metafields de variante.
3. Agregue definiciones de metafield específicas para limitar qué metafields se comparten.
   * Haga clic en el icono **Explorar metafields (Browse metafields)**, o
   * Ingrese la definición del metafield con el formato:

     ```
     namespace.key
     ```

     Por ejemplo:

     ```
     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>

***

### 🛠️ Paso 2: configure los metafields en la tienda de destino

1. Abra la aplicación > haga clic en **Tiendas (Stores)** > haga clic en la URL de la tienda de origen para abrir los detalles de la conexión

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

2. Active **Sincronización de metafields (Metafields sync)**
3. Elija qué sincronizar

   En **Permitir datos (Allow data)**, seleccione una o ambas opciones:

   * **Recurso de producto** → sincroniza metafields de producto
   * **Recurso de variante** → sincroniza metafields de variante
4. Haga clic en el icono de búsqueda de la derecha para ver todos los metafields compatibles > haga clic en el botón **Seleccionar metafield válido para sincronizar (Select valid metafield to sync)**

<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. Haga clic en **Guardar** para guardar los cambios

***

### 🔄 Qué ocurre durante la sincronización

#### **1) Si la tienda de destino no tiene la definición del metafield**

La aplicación creará automáticamente la definición del metafield en la tienda de destino (cuando sea necesario).

Una vez creada, los valores de metafield sincronizados aparecerán en el producto o la variante de la tienda de destino.

#### **2) Si existen metafields pero no están “estructurados” (metafields no estructurados)**

En algunos casos, los metafields pueden sincronizarse aunque no se hayan definido o estructurado por completo en la tienda de destino.

Para revisarlos en Shopify Admin:

* **Abra** **Configuración → Metafields y metaobjetos (Settings → Metafields and metaobjects)** de la tienda
* Elija **Producto (Product)** (o **Variante (Variant)**)
* Abra **Ver metafields no estructurados (View unstructured metafields)**

💡 Consejo: más adelante puede definir o estructurar estos metafields manualmente para mantener los datos de su tienda limpios y consistentes.

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

#### **3) Si la tienda de origen no tiene valor, la de destino no se sobrescribe**

Si un metafield existe en la tienda de destino pero el valor de la tienda de origen está vacío, Tipo Sync no sobrescribirá el valor de destino.

#### **4) Los tipos de datos deben coincidir (muy importante)**

Los tipos de datos del metafield deben coincidir exactamente entre la tienda de origen y la de destino.

Ejemplos de tipos de datos que no coinciden:

* `single_line_text_field` frente a `multi_line_text_field`
* `number_integer` frente a `number_decimal`
* `product_reference` frente a `text`

⚠️ Si los tipos de datos no coinciden, la sincronización puede fallar u omitir ese metafield.

***

### 📌 Ejemplo: sincronizar un metafield de producto – “Material”

Desea sincronizar un **metafield de producto personalizado** llamado **Material** (p. ej., “Cotton”, “Leather”, “Wool”) de su **tienda de origen** a su **tienda de destino** usando nuestra aplicación.

#### **Paso 1: defina el metafield en Shopify**

En su **tienda de origen**:

1. Vaya a **Shopify Admin >** abra **Configuración > Metafields y metaobjetos (Settings > Metafields and metaobjects)** de la tienda > elija **Producto** (o **Variante**)
2. Haga clic en **Agregar definición (Add definition)** (si aún no está creada) > complete la definición del metafield:
   * **Nombre (Name)**: Material
   * **Espacio de nombres (Namespace)**: `custom`
   * **Clave (Key)**: `material`
   * **Tipo (Type)**: Texto de una sola línea (Single line text)

\=>  Esto le da la clave completa del metafield: `custom.material`

Repita este paso en su **tienda de destino** (la clave y el tipo deben coincidir).

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

#### **Paso 2: agregue datos de metafield a los productos**

En su **tienda de origen**, vaya a un producto y desplácese hasta **Metafields**  > En **Material**, ingrese: `Cotton`

Ahora este producto tiene el metafield `custom.material = "Cotton"`.

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

#### **Paso 3: configure la sincronización en la aplicación Tipo**

* Abra nuestra aplicación en la **tienda de destino** > vaya a **Configuración de la conexión (Connect Configuration) > Sincronización de metafields**
* Elija **Metafields específicos (Specific Metafields) >** ingrese la clave del metafield exactamente así: `custom.material`

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

**Resultado**

* Nuestra aplicación encontrará `custom.material` en la tienda de origen
* Si **no existe** en el producto de la tienda de destino, la aplicación lo **creará**\
  \=>   Resultado: `custom.material = "Cotton"` en ambas tiendas
* Si existe en la tienda de destino pero el valor de origen está vacío, **no sobrescribimos** el valor

***

### ❓Preguntas frecuentes

#### P1: ¿Cómo establezco `namespace.key` en mi tienda?

Para sincronizar un metafield específico, deberá introducir la **clave de definición del metafield** con este formato: `namespace.key` (por ejemplo: `custom.color`).

Así puede encontrarla en su Shopify Admin:

1. Vaya a su Shopify Admin > navegue a **Configuración > Datos personalizados > Productos (Settings > Custom Data > Products)**
2. Haga clic en el metafield que desea sincronizar\
   → Verá los valores de **Espacio de nombres** y **Clave**
3. Combínelos con este formato: `namespace.key`\
   → Ejemplo: `custom.description`

#### P2: ¿Por qué no se sincronizan mis metafields?

Si sus metafields no se sincronizan correctamente, puede deberse a una de las siguientes razones:

1. **La sincronización de metafields no está activada**\
   Asegúrese de que la sincronización de metafields esté activada en ambas tiendas:
   * Active **Compartir metafields** en la **tienda de origen**.
   * Active **Recibir metafields (Receive Metafields)** en la **tienda de destino**.

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

2. **No se ha agregado la clave de definición del metafield**

Además de habilitar la sincronización de metafields, también debe agregar la **clave de definición del metafield (namespace.key)** que desea sincronizar.

* Vaya a **Configuración → Compartir metafields**
* Asegúrese de que **Activar (Enable)** esté marcado
* En **Permitir datos**, agregue la definición del metafield con este formato:\
  `namespace.key`\
  Ejemplo: `custom.material`

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

3. **Tipos de metafield no compatibles**\
   Algunos tipos de datos de metafield no son compatibles, como los **tipos de referencia** o los **MetaObjects**.

Rojo: metafields no compatibles que la aplicación no puede sincronizar

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

4. **Tipos de metafield que no coinciden entre tiendas**\
   El metafield de la tienda de origen y el de la tienda de destino deben tener **el mismo tipo de datos y la misma estructura**.\
   Los desajustes más comunes son:

* Un metafield es de **Texto de una sola línea** y el otro es de **Texto de varias líneas**.
* Un metafield usa **Valor único (Single value)** y el otro usa **Lista de valores (List of values)**.

Para solucionarlo, confirme que los metafields de ambas tiendas tengan el mismo **espacio de nombres**, **clave** y **tipo de datos**, y vuelva a intentar la sincronización.

***

**🙋 ¿Necesita más ayuda?**

Si todavía necesita ayuda, escríbanos a <hi@tipo.io>. Estaremos encantados de ayudarle.
