Shopify

Sync Data

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

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

Configurar Sync #

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

Requisitos de acceso: Solo los propietarios de la tienda o el personal con permisos de Administrador pueden crear la app (no mediante acceso colaborativo). Si la configuración es para un cliente, necesitas acceso de personal o las credenciales de la app de parte de él.

Crear la app #

  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 directamente el Dev Dashboard después de iniciar sesión.

  5. En el Developer Dashboard, haz clic en Create App.

  6. Ingresa Clerk.io como nombre de la app.

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

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

  9. En Webhooks API Version, selecciona la versión más reciente (al menos 2025-07).

Configurar permisos (scopes) #

  1. Bajo Access scopes, otorga acceso a los permisos listados a continuación. Puedes pegar la siguiente cadena directamente en el campo de entrada para agregar todos los permisos a la 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 seleccionarlos 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 app #

  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 Shopify en la que instalar la app. Elige tu tienda de la lista.

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

Conectar a Clerk #

  1. Regresa al Developer Dashboard y haz clic en Settings dentro de la app Clerk.io. Aquí encontrarás el Client ID y el Client Secret.

  2. Ve 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.

Incidencia conocida: Shopify puede fallar al 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 prueba sincronizar de nuevo.

Markets e inventario #

Si trabajas con múltiples mercados, idiomas 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 de tu Shopify. Para un mapeo de campos completo, consulta Shopify integration settings.

Datos de variantes #

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

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

  • variant_inventory_policy (lista de cadenas)
  • variant_inventory_tracking (lista de valores 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 las variantes que están en stock.

Personalización de datos de productos #

En Shopify, los metacampos y otros atributos creados pueden ser sincronizados a través de my.clerk.io > System status > Data sync.

Simplemente accede al campo de entrada llamado Custom Attributes y escribe los atributos de producto a incluir.

Para agregar varios atributos, sepáralos con comas.

Add attributes

Los atributos deben escribirse siempre usando su key.

Esto usualmente será en minúsculas. Por ejemplo, el atributo “Sizes” debe ser “sizes”.

No necesitas incluir el namespace - Clerk lo detectará automáticamente basado en el key.

En Shopify, puedes encontrarlo buscando tu atributo en Settings > Custom data > Products/Variants:

Custom data

Sincronizar suscriptores #

Shopify permite gestionar suscriptores directamente en la plataforma.

Estos pueden ser sincronizados fácilmente con Clerk.

Al activarlo, importaremos el atributo “subscribed: true” para cualquier dirección Email que esté suscrita en Shopify.

Esto puede usarse luego para Auto-Email.

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

Subscriber state configuration

Si deseas usar un enlace para dar de baja a clientes, cada cliente extraído de un backend de Shopify tiene un atributo unsub_url que puede ser usado en los diseños de auto email en el campo de baja: {{customer.unsub_url}}

La versión de Webhooks API debe estar configurada al menos en 2022-04, donde se añadió esta función. Puedes comprobarlo en la app creada para Clerk en el Developer Dashboard bajo Settings.

App personalizada heredada (Legacy Custom App) #

Desde enero de 2026, Shopify ya no permite crear apps personalizadas directamente en el administrador de la tienda Shopify. Las apps personalizadas ya existentes seguirán funcionando, pero este método solo debe usarse si ya tienes una app personalizada configurada. Para todas las demás configuraciones, utiliza 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 Shopify aún tiene acceso para crear apps 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, nómbrala “Clerk.io”, selecciona el desarrollador de la app y vuelve a hacer clic en Create app.

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

Permissions configuration

  1. Bajo Admin API access scopes, otorga acceso de solo lectura (permisos que empiezan con read_) a lo siguiente. Para Customers, seleccione Leer y escribir (incluye write_customers) ya que Shopify lo requiere para acceder a los campos de URL de marketing de clientes (por ejemplo, para customer.unsub_url).

    Puedes pegar la siguiente cadena directamente 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 seleccionarlos 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 en Install App → Install.

  2. Abre API Credentials y copia tu Shopify Domain y las credenciales API Key, Access Token y Secret Key de tu app.

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 el 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.