Conexión de Shopify

Introducción

Una conexión de Shopify, creada utilizando el conector de Shopify, establece acceso a Shopify. Una vez que se configura una conexión, se pueden crear instancias de actividades de Shopify asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Shopify

Una nueva conexión de Shopify se crea utilizando el conector de Shopify desde una de estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La página de Puntos finales globales (ver Crear un punto final global en Puntos finales globales).

Una conexión de Shopify existente se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña de componentes del panel del proyecto).
• La página de Puntos finales globales (ver Editar un punto final global en Puntos finales globales).

Configurar una conexión de Shopify

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Shopify se describe a continuación.

• Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Shopify y no debe contener barras inclinadas / ni dos puntos :. Este nombre también se utiliza para identificar el endpoint de Shopify, que se refiere tanto a una conexión específica como a sus actividades.

• Nombre de la tienda: Ingresa el nombre de la tienda de Shopify.

• Tipo de autenticación: Selecciona el tipo de autenticación, uno de Autenticación básica o Token de acceso de Shopify. Si estás utilizando una aplicación privada, selecciona Autenticación básica. Si estás utilizando una aplicación personalizada creada en el administrador de Shopify, selecciona Token de acceso de Shopify.

• Clave API: Si se seleccionó Autenticación básica como el Tipo de autenticación, ingresa la clave API para la instancia de Shopify.

• Contraseña: Si se seleccionó Autenticación básica como el Tipo de autenticación, ingresa la contraseña para la instancia de Shopify.

• Token de acceso API: Si se seleccionó Token de acceso de Shopify como el Tipo de autenticación, ingresa el token de acceso API para la instancia de Shopify.

• Configuraciones opcionales: Haz clic para expandir configuraciones adicionales:

  • Usar configuraciones de proxy (Solo agente privado): Al usar un agente privado, se puede seleccionar esta configuración para usar configuraciones de proxy de agente privado.

  • Versión de API: Selecciona la versión de la API REST Admin de Shopify, una de 2022-04 (predeterminada), 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04, 2024-07, 2024-10, 2025-01, 2025-04, o 2025-07. Dependiendo de los endpoints de API soportados por Shopify en la versión de API que se está utilizando, los objetos y sub-objetos que están disponibles para selección durante la configuración de actividades pueden variar. Si cambias la Versión de API para una conexión que tiene actividades configuradas existentes, consulta consideraciones adicionales en Cambiar la versión de API a continuación.

    Importante

    Shopify publica una nueva versión de la API cada tres meses y mantiene cada versión lanzada por un mínimo de doce meses. Una vez que una versión de la API es desaprobada, Shopify ya no mantendrá esa versión, y cualquier llamada a la API que solicite esa versión será automáticamente redirigida a la versión estable más antigua actualmente soportada.

    Shopify puede desaprobar ciertos endpoints con la introducción de una nueva versión de la API. Como resultado, es posible que necesites cambiar tus aplicaciones y configuraciones de actividad debido a características cambiadas o retiradas.

    Las versiones y endpoints de la API desaprobados se anuncian en el registro de cambios de Shopify, donde se encuentran disponibles más detalles y cualquier información relevante sobre migración.

  • Encabezados de Solicitud: Usa esta tabla para agregar cualquier par clave-valor que se enviará con cada solicitud de actividad. Cada valor agregado a la tabla se incluye en el esquema de solicitud de cada actividad.

    • Agregar: Agrega una fila a la tabla. Ingresa un par clave-valor para cada propiedad.
    • Enviar: Guarda el par clave-valor en la tabla. Visible al pasar el cursor sobre una fila en modo de edición.
    • Descartar: Descarta una nueva fila o cualquier edición realizada en una fila existente. Visible al pasar el cursor sobre una fila en modo de edición.
    • Editar: Permite editar un par clave-valor existente. Visible al pasar el cursor sobre una fila existente.
    • Eliminar: Elimina la fila de la tabla. Visible al pasar el cursor sobre una fila existente.
    • Limpiar Todo: Elimina todas las filas de la tabla.

    Importante

    Los campos en la tabla de Encabezados de Solicitud muestran el ícono de variable solo en modo de edición. Para que los valores de variable de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

Los campos en la tabla de Encabezados de Solicitud no admiten el uso de variables para pasar JSON sin procesar. Si tu caso de uso no admite definir JSON sin procesar en los campos directamente, escapa el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

• Prueba: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la Desactivar Actualización Automática del Conector política de organización.

• Guardar Cambios: Haz clic para guardar y cerrar la configuración de la conexión.

• Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Cambiar la versión de la API

Si una conexión de Shopify tiene actividades configuradas existentes, hay consideraciones adicionales a tener en cuenta al cambiar la Versión de la API seleccionada. Esto se debe a que los objetos y sub-objetos disponibles para selección en la configuración de la actividad dependen de los puntos finales de la API admitidos por Shopify en la versión de la API que se está utilizando. Si la configuración de actividad existente utiliza puntos finales de la API que no son compatibles con la versión de la API a la que estás cambiando, entonces esas actividades fallarán a menos que sean reconfiguradas.

Para prevenir que esto ocurra, sigue estos pasos:

1. Cambia la versión de la API en la conexión de Shopify.

2. Abre cada pantalla de configuración de actividad donde se seleccione un objeto o subobjeto y haz clic en Actualizar. Al actualizar, se recuperarán las listas de selección del objeto y subobjeto actuales utilizando la versión de API seleccionada en la conexión de Shopify. Ten en cuenta que Shopify redirige automáticamente las llamadas de versiones de API no soportadas a la siguiente versión más antigua soportada.

   Importante

   Si el objeto o subobjeto seleccionado no es compatible con la versión de API que se está llamando, la selección puede cambiar al actualizar. Presta mucha atención para asegurarte de que cualquier selección cambiada sea la deseada.

3. Selecciona el objeto y subobjeto apropiados que sean compatibles con la versión de API que se está llamando.

4. Reimplementa operaciones utilizando la conexión y actividades.

Siguientes pasos

Después de que se ha creado una conexión de Shopify, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• Leer: Recupera datos de objetos de Shopify y está destinado a ser utilizado como fuente en una operación.

• Consultar: Consulta datos de objetos de Shopify y está destinado a ser utilizado como fuente en una operación.

• Crear: Crea datos de objetos en Shopify y está destinado a ser utilizado como destino en una operación.

• Actualizar: Actualiza datos de objetos en Shopify y está destinado a ser utilizado como destino en una operación.

• Eliminar: Elimina datos de objetos de Shopify y está destinado a ser utilizado como destino en una operación.