Shopify

Sync Data

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

Sincroniza tus productos de Shopify, meta-campos y suscriptores con Clerk. Esta guía cubre la creación de una aplicación en el Panel de Desarrolladores de Shopify, la personalización de los datos de productos y la sincronización de la información de suscriptores.

Configurar la sincronización #

Para sincronizar los datos de tu tienda Shopify con Clerk, necesitas crear una aplicación en el Panel de Desarrolladores de Shopify y configurarla en Clerk. El usuario que configure la sincronización debe tener acceso al Panel de Desarrolladores y permisos para desarrollar aplicaciones en la tienda de Shopify.

Requisitos de acceso: Solo los propietarios de la tienda o el personal con permisos de Administrador pueden crear la aplicación (no mediante acceso colaborativo). Si configuras para un cliente, necesitas acceso de personal o las credenciales de la aplicación de ellos.

Crear la aplicación #

  1. En Shopify, haz clic en Settings.

  2. Haz clic en Apps and sales channels.

  3. Haz clic en Develop apps.

  4. Haz clic en Build apps in Dev Dashboard.

    • Si no ves esta opción, haz clic en Learn more.
    • En la nueva ventana que se abre, haz clic en Go to Dev Dashboard.
    • Alternativamente, puedes abrir el Dev Dashboard directamente después de iniciar sesión.

  5. En el Panel de Desarrolladores, haz clic en Create App.

  6. Ingresa Clerk.io como el nombre de la aplicación.

  7. En App URL, agrega el marcador de posición estándar de Shopify: https://shopify.dev/docs/apps/default-app-home

  8. Bajo Embed App in Shopify Admin, elimina la marca de verificación. La aplicación solo necesita instalarse una vez y no es necesario que aparezca en el menú lateral de Shopify.

  9. En Webhooks API Version, selecciona la última versión (al menos 2025-07).

Configurar los alcances #

  1. En Access scopes, concede acceso a los siguientes alcances. Puedes pegar la siguiente cadena directamente en el campo de entrada para agregar todos los alcances 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
    ¿Por qué necesitamos acceso de escritura? Clerk solo lee datos, pero Shopify requiere el alcance write_customers para acceder a los campos de URL de marketing de clientes (por ejemplo, para sincronizar customer.unsub_url).

    O puedes elegirlos individualmente:

    • Customers (read_ y write_)
    • Inventory (read_)
    • Locales (read_)
    • Locations (read_)
    • Markets (read_)
    • Markets Home (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Publications (read_)
    • Store Content (read_)
    • Translations (read_)

  2. Al final de la pantalla, haz clic en Release.

Instalar la aplicación #

  1. Haz clic en Home, luego haz clic en Install app en la esquina superior derecha.

  2. Shopify te redirige a una página donde seleccionas la tienda de Shopify en la que instalar la aplicación. Elige tu tienda de la lista.

  3. En la página siguiente, revisa el resumen de los detalles de la aplicación y haz clic en Install en la esquina inferior derecha.

Conectar con Clerk #

  1. Vuelve al Panel de Desarrolladores y haz clic en Settings dentro de la aplicación Clerk.io. Aquí encontrarás el Client ID y el Client Secret.

  2. Dirígete a my.clerk.io > Data > Configuration. Bajo Sync Method, selecciona Shopify.

  3. Pega el Client ID y el Client Secret en el formulario. Luego haz clic en Start Sync.

Problema conocido: Shopify puede no generar un token en la primera sincronización, causando un error de autenticación. Este es un problema intermitente conocido en Shopify. Simplemente espera 1-2 minutos, luego intenta sincronizar de nuevo.

Mercados e inventario #

Si gestionas varios mercados de Shopify, idiomas o ubicaciones de inventario, 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 de tu Shopify. Para un mapeo campo por campo completo, consulta Shopify integration settings.

Datos de variantes #

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

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

  • variant_inventory_policy (lista de cadenas)
  • variant_inventory_tracking (lista booleana)
  • 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 variante)

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á habilitado, estas listas solo incluirán variantes en stock.

Personalización de datos de productos #

En Shopify, los meta-campos 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 productos que quieras incluir.

Para agregar varios atributos, sepáralos con comas.

Add attributes

Los atributos siempre deben escribirse utilizando su key.

Normalmente estarán en minúscula. Por ejemplo, el atributo “Sizes” debe ser “sizes”.

No necesitas incluir el namespace - Clerk lo encontrará automáticamente basándose en el key.

En Shopify, a menudo puedes encontrar estas claves buscando tu atributo en Settings > Custom data > Products/Variants:

Custom data

Sincronizar suscriptores #

Shopify permite gestionar suscriptores directamente en la plataforma.

Estos pueden sincronizarse fácilmente con Clerk.

Cuando está activado, importaremos ese atributo “subscribed: true” para cualquier dirección de correo electrónico que esté suscrita en Shopify.

Esto se puede usar luego para Auto-Email.

Simplemente ve a tu tienda en my.clerk.io, luego Data -> Configuration y configura Include Subscriber State en Yes. Luego haz clic en Save y comienza una nueva sincronización.

Subscriber state configuration

Si deseas usar un enlace de cancelación de suscripción para clientes, entonces cada cliente que se extrae desde un backend de Shopify tiene un atributo unsub_url que puede usarse para los diseños de auto email en el campo de cancelar suscripción: {{customer.unsub_url}}

La versión de la Webhooks API debe estar configurada al menos en 2022-04, donde se agregó este soporte. Puedes verificar esto en la aplicación que creaste para Clerk en el Panel de Desarrolladores bajo Settings.

Aplicación personalizada heredada #

Desde enero de 2026, Shopify ya no permite crear aplicaciones personalizadas directamente en el administrador de la tienda. Las aplicaciones personalizadas existentes siguen funcionando, pero este método solo debe usarse si ya tienes una aplicación personalizada configurada. Para todas las demás configuraciones, utiliza el método del Panel de Desarrolladores anterior.

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

Estos pasos solo aplican si tu tienda Shopify aún tiene acceso para crear aplicaciones personalizadas en el administrador.

  1. En Shopify, ve a Apps > App and sales channel settings y haz clic en Develop apps.
Develop apps page

  1. Haz clic en Create app, nombra la aplicación “Clerk.io”, elige el desarrollador de la aplicación, luego haz clic de nuevo en Create app.

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

Permissions configuration

  1. En Admin API access scopes, concede acceso de solo lectura (alcances que comiencen con read_) a lo siguiente. Para Customers, configúralo en lectura y escritura (incluye write_customers).

    ¿Por qué necesitamos acceso de escritura? Clerk solo lee datos, pero Shopify requiere el alcance write_customers para acceder a los campos de URL de marketing de clientes (por ejemplo, para sincronizar customer.unsub_url).

    Puedes pegar la siguiente cadena directamente en el campo de entrada para agregar todos los alcances 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:

    • Customers (read_ y write_)
    • Inventory (read_)
    • Locales (read_)
    • Locations (read_)
    • Markets (read_)
    • Markets Home (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Publications (read_)
    • Store Content (read_)
    • Translations (read_)
API access scopes

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

  2. Abre API Credentials y copia tu Dominio de Shopify y la API Key, Access Token y Secret Key de la aplicación.

API credentials

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

  2. Pega estos valores en el formulario. Elige un tamaño de imagen predeterminado si se solicita, 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.