Shopify

Sync Data

Aprende cómo sincronizar y personalizar datos de tu tienda de Shopify

Sincroniza tus productos de Shopify, metacampos y suscriptores con Clerk.io. Esta guía cubre la creación de una app en el Dev Dashboard de Shopify, la personalización de los datos de productos y la sincronización de la información de suscriptores.

Configurar la sincronización #

La configuración tiene dos partes: crear e instalar una app en Shopify, y luego ingresar sus credenciales en my.clerk.io. Completa ambas partes antes de iniciar la primera sincronización.

Antes de configurar la sincronización, asegúrate de tener el dominio actual de la tienda .myshopify.com. Sigue los pasos para el dominio de Shopify si es necesario.

En Shopify #

Completa estos pasos en el Dev Dashboard de Shopify. Consulta la guía actual de apps en Dev Dashboard de Shopify si cambian las etiquetas.

Crear la app #

  1. Abre el Shopify Dev Dashboard e inicia sesión.
  2. En la navegación izquierda, abre Apps y haz clic en Create app.
  3. Selecciona Start from Dev Dashboard, ingresa Clerk.io como nombre de la app y haz clic en Create.

Configurar la app #

  1. Abre la pestaña Versions para la nueva app.
  2. En App URL, ingresa https://shopify.dev/apps/default-app-home. La app solo proporciona acceso mediante API y no necesita una interfaz de administrador embebida.
  3. En Webhooks API Version, selecciona la versión más reciente disponible.
  4. Agrega los permisos (scopes) listados en la siguiente sección.

Configurar permisos (scopes) #

Comienza con los siguientes permisos. Permiten a Clerk.io importar el catálogo, pedidos, clientes, páginas, mercados, ubicaciones y los datos relacionados que se necesitan para la integración con Shopify. Pega esta lista en el campo de permisos:

Omite read_all_orders al crear la primera versión para evitar el error de “permisos inválidos”. Lo agregarás en una segunda versión antes de instalar la app.

read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations
¿Por qué se necesita acceso de escritura? Clerk.io solo lee los datos, pero Shopify requiere el permiso write_customers para acceder a los campos de URL de marketing de los clientes, como customer.unsub_url.

También puedes elegir los permisos individualmente:

  • Clientes (read_ y write_)
  • Inventario (read_)
  • Locales (read_)
  • Ubicaciones (read_)
  • Mercados (read_)
  • Markets Home (read_)
  • Metaobjetos (read_)
  • Páginas de la tienda online (read_)
  • Pedidos (read_)
  • Productos (read_)
  • Publicaciones (read_)
  • Contenido de la tienda (read_)
  • Traducciones (read_)

Haz clic en Release para publicar la primera versión con estos permisos y luego agrega el acceso a todos los pedidos a continuación.

Agregar todos los pedidos #

Agrega read_all_orders en una segunda versión para que Clerk.io pueda importar el historial completo de pedidos de la tienda.

  1. En el Dev Dashboard, abre la pestaña Versions de la app y haz clic en Create Version.
  2. Mantén los permisos existentes y agrega ,read_all_orders al final del campo de permisos.
  3. Guarda la configuración como una nueva versión.
  4. Haz clic en Release en la parte inferior.
  5. Si se solicita, opcionalmente ingresa un mensaje de versión como Read all orders was added, y completa la publicación.

La lista completa de permisos para esta segunda versión es:

read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations,read_all_orders

Instalar la app #

Instala la app publicada en la tienda de Shopify que se sincronizará con Clerk.io.

  1. En la app, abre Home y haz clic en Install app.
  2. Selecciona o crea la tienda de Shopify.
  3. Revisa los permisos solicitados y haz clic en Install.

En Clerk.io #

Completa estos pasos en my.clerk.io usando las credenciales de Shopify. El equipo de la tienda puede hacerlo directamente, o compartir de forma segura las credenciales con un tercero que esté configurando la sincronización de Clerk.io.

Configurar la sincronización #

  1. En el Shopify Dev Dashboard, abre los Settings de la app Clerk.io y copia el Client ID y el Client Secret, o consíguelos mediante una transferencia segura aprobada por el equipo de la tienda de Shopify.
  2. En my.clerk.io, abre la tienda correspondiente y ve a Data > Configuration.
  3. Establece Sync Method en Shopify.
  4. Ingresa el dominio .myshopify.com actual de la tienda de Shopify en Shopify Domain. No ingreses el dominio personalizado público, https:// ni una ruta.
  5. Pega el Client ID y el Client Secret en los campos correspondientes.
  6. Haz clic en Save, luego haz clic en Start Sync.

Mantén el Client Secret privado. Compártelo solo por un canal seguro aprobado, y nunca lo incluyas en un documento público, ticket de soporte o chat.

Problema conocido: Shopify puede fallar en generar un token en la primera sincronización, causando un error de autenticación. Es un problema intermitente conocido en Shopify. Simplemente espera 1-2 minutos y vuelve a intentar sincronizar.

Mercados e inventario #

Si tienes varios mercados, locales o ubicaciones de inventario en Shopify, confirma estos campos antes de sincronizar:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Ubicaciones de inventario

Estos valores deben coincidir con la configuración de mercado/dominio en Shopify. Para un mapeo completo campo por campo, consulta los ajustes de integración de Shopify.

Datos de variantes #

Los datos de variante en Shopify pueden comportarse de manera diferente según la configuración Import only stock variant data.

Los atributos típicos de variantes de Shopify en Clerk.io incluyen:

  • variant_inventory_policy (lista de cadenas)
  • variant_inventory_tracking (lista de booleanos)
  • variant_list_prices (lista numérica)
  • variant_names (lista de cadenas)
  • variant_option_size (lista de cadenas)
  • variant_prices (lista numérica)
  • variant_stocks (lista numérica)
  • variant_weight (lista numérica)
  • variant_weight_unit (lista de cadenas)
  • variants (lista de cadenas, IDs de variantes)

Ejemplo:

{
  "variant_inventory_policy": ["deny", "deny"],
  "variant_inventory_tracking": [true, true],
  "variant_list_prices": [240, 240],
  "variant_names": ["Xs", "M"],
  "variant_option_size": ["Xs", "M"],
  "variant_prices": [120, 120],
  "variant_stocks": [1, 7],
  "variant_weight": [0.4, 0.4],
  "variant_weight_unit": ["KILOGRAMS", "KILOGRAMS"],
  "variants": ["55970989179259", "55970989244795"]
}

Cuando Import only stock variant data está activado, estas listas solo incluyen variantes en stock.

Personalizar datos de productos #

En Shopify, los metacampos y otros atributos que crees pueden sincronizarse mediante my.clerk.io > System status > Data sync.

Simplemente ve al campo de entrada llamado Custom Attributes y escribe los atributos de los productos que quieras incluir.

Para agregar varios atributos, sepáralos con comas.

Los atributos siempre deben escribirse usando su key.

Esto generalmente será todo en minúscula. Por ejemplo, el atributo “Sizes” debería ser “sizes”.

No necesitas incluir el namespace - Clerk.io lo encontrará automáticamente en función de la key.

En Shopify, encuentra las claves de atributos en Settings > Custom data > Products/Variants.

Sincronizar suscriptores #

Shopify permite gestionar suscriptores directamente en la plataforma.

Estos pueden sincronizarse fácilmente con Clerk.io.

Cuando se activa, importaremos el atributo “subscribed: true” para cualquier dirección de correo que esté suscrita en Shopify.

Esto luego puede usarse para Auto-Email.

Simplemente ve a tu tienda en my.clerk.io, luego a Data -> Configuration y establece Include Subscriber State en Yes. Después haz clic en Save e inicia una nueva sincronización.

Si quieres usar un enlace de baja para los clientes, cada cliente recuperado de un backend de Shopify tiene el atributo unsub_url que puede usarse para los diseños de auto email en el campo de baja: {{customer.unsub_url}}

La versión de la Webhooks API debe ser al menos 2022-04, donde se añadió este soporte. Puedes comprobarlo en la app que creaste para Clerk.io en el Dev Dashboard, bajo Settings.

App personalizada heredada #

Desde enero de 2026, Shopify ya no permitirá crear apps personalizadas directamente en el administrador de Shopify para las tiendas. Las apps personalizadas existentes seguirán funcionando, pero este método solo debe usarse si ya tienes una app personalizada configurada. Para todas las demás configuraciones, usa el método del Developer Dashboard anterior.

Si tienes una app personalizada existente y necesitas usarla o modificarla, selecciona Shopify (Legacy Custom App) como Sync Method en my.clerk.io > Data > Configuration.

Estos pasos solo aplican si tu tienda de Shopify todavía tiene acceso para crear apps personalizadas en el administrador de Shopify.

  1. En Shopify, ve a Settings > Apps > Develop Apps.

  2. Haz clic en Create app, nómbrala “Clerk.io”, elige el desarrollador de la app y luego haz clic de nuevo en Create app.

  3. Haz clic en Configuration → Admin API integration → Configure.

  4. Bajo Admin API access scopes, otorga acceso de solo lectura (permisos que empiezan por read_) a lo siguiente. Para Customers, asígnale lectura y escritura (incluye write_customers).

    ¿Por qué se necesita acceso de escritura? Clerk.io solo lee los datos, pero Shopify requiere el permiso write_customers para acceder a los campos de URL de marketing del cliente (por ejemplo, para sincronizar customer.unsub_url).

    Puedes pegar la siguiente cadena directamente en el campo para agregar todos los permisos de una vez:

    read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations

    O puedes elegirlos individualmente:

    • Clientes (read_ y write_)
    • Inventario (read_)
    • Locales (read_)
    • Ubicaciones (read_)
    • Mercados (read_)
    • Markets Home (read_)
    • Metaobjetos (read_)
    • Páginas de la tienda online (read_)
    • Pedidos (read_)
    • Todos los pedidos (read_)
    • Productos (read_)
    • Publicaciones (read_)
    • Contenido de la tienda (read_)
    • Traducciones (read_)

  5. Haz clic en Save, luego en Install App → Install.

  6. Abre API Credentials y copia tu Shopify Domain y la API Key, Access Token y Secret Key de la app.

  7. Ve a my.clerk.io > Data > Configuration. Bajo Sync Method, selecciona Shopify (Legacy Custom App).

  8. Pega estos valores en el formulario. Elige un tamaño de imagen por defecto si se solicita y luego haz clic en Start Sync.

Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.