Shopify: Configuración Parte 1 (Shopify)

Sigue los pasos indicados a continuación para instalar relBase en Shopify.

En este artículo se detalla la configuración necesaria en Shopify para establecer la conexión con relBase. En particular, se explican los siguientes procesos:

• Creación de la aplicación de relBase en Shopify. (Pasos 1-7)

• Configuración de los webhooks en Shopify. (Pasos 8-9)

Paso 1: Acceder a la configuración de aplicaciones en Shopify

Se debe ingresar a la cuenta de Shopify y dirigirse a: Configuración → Aplicaciones y canales de ventas → Desarrollar aplicaciones.

 

Paso 2: Creación de la Aplicación 

En esta sección debe:

1.- Hacer clic en Crear aplicación.

2.- Ingresar "relBase" en el campo Nombre de la aplicación y presiona el botón Crear aplicación para continuar.

 

Paso 3: Configuración de los alcances de la API

A continuación, se debe seleccionar "Configurar permisos de la API de admin" o "Integración de la API de admin" y modificar únicamente los permisos del siguiente paso:

 

Paso 4: Modificación de Permisos

Modifica únicamente los siguientes permisos:

• Inventario (Inventory): Leer y escribir (write_inventory y read_inventory).
• Sucursales (Locations): Solo lectura (read_locations).
• Productos (Products, variants and collections): Solo lectura (read_products.
• Pedidos (Orders, transactions and fulfillments): Solo lectura (read_orders).
• Pedidos de preparación asignados: Solo lectura (read_orders).
• Pedidos de preparación gestionados por el comerciante: Solo lectura (read_orders).
• Pedidos en preparación de terceros: Solo lectura (read_orders).

 

Paso 5: Configuración de Suscripciones de Webhooks

En la sección "Suscripciones de Webhook", seleccione la opción "Versión candidata", luego presiona el botón "Guardar".

💡 Nota: Shopify publica una nueva versión de su API cada 3 meses. Con el tiempo, las versiones más antiguas quedan obsoletas y Shopify las elimina. Por esta razón, se recomienda actualizar la versión utilizada al menos una vez al año para mantener la conexión funcionando sin problemas.

 

Paso 6: Credenciales de la API

Ve a la pestaña "Credenciales de API" y presiona el botón "Instalar app".

💡 Nota: Shopify mostrará un mensaje de advertencia indicando si esta seguro de instalar una nueva aplicación con acceso a la API y datos de la tienda. Haz clic en el botón "Instalar" para proceder con la instalación.

 

Paso 7: Visualización y copia de credenciales desde Shopify hacia relBase

Una vez creada la aplicación en Shopify, se mostrarán las credenciales necesarias para permitir  que relBase pueda conectarse con la tienda de Shopify.

Es importante guardar estos datos de forma segura, ya que serán requeridos al configurar la integración en relBase.

 

En el momento de crear la conexión en relBase, se deben copiar las credenciales de Shopify en los siguientes campos:

• Copia el contenido del campo "Token de acceso a la API de Admin" de Shopify y pégalo en el campo "Contraseña" de la configuración de la integración en relBase.
• Copia el contenido del campo "Clave API" de Shopify y pégalo en el campo "Clave API" de la configuración de la integración en relBase.
• Copia el contenido del campo "Clave secreta de la API" de Shopify y pégalo en el campo "Secreto compartido" de la configuración de la integración en relBase.
  

Paso 8: Configuración de Notificaciones de Shopify

Para recibir notificaciones sobre nuevos pedidos o la creación de productos, se deben crear los webhooks, por lo que se debe ingresar a: Configuración → Notificaciones → Webhooks.

 

Paso 9: Creación de Notificaciones

Se deben crear 5 notificaciones (webhooks) con la siguiente configuración y tokens:

• El token relBase debe ser proporcionado por el equipo de relBase. Para obtenerlo, envía un correo a contacto@relbase.cl.
• El token webhook shopify se encuentra en la sección Webhooks y esta después del texto "Tus webhooks se firmarán con".

Notificación 1: Actualización del Pedido

• • Evento: Selecciona la opción "Actualización del pedido".
  • Ingresar URL: https://app.relbase.cl/ecommerce/procesar-pedido/shopify/token relbase/token webhook shopify
  • Versión de la API de Webhook: Selecciona la opción "Versión candidata".
  • Haz clic en el botón "Guardar webhook".
    
    

Notificación 2: Cancelación de Pedido

• • Evento: Selecciona la opción "Cancelación de pedido".
  • Ingresar URL: https://app.relbase.cl/ecommerce/procesar-pedido/shopify/token relbase/token webhook shopify
  • Versión de la API de Webhook: Selecciona la opción "Versión candidata".
  • Haz clic en el botón "Guardar webhook".
    
    

Notificación 3: Creación de Producto

• • Evento: Selecciona la opción "Creación de producto".
  • Ingresar URL: https://app.relbase.cl/ecommerce/actualizar-producto/shopify/token relbase/token webhook shopify
  • Versión de la API de Webhook: Selecciona la opción "Versión candidata".
  • Haz clic en el botón "Guardar webhook".
    
    

Notificación 4: Actualización de Producto

• • Evento: Selecciona la opción "Actualización de producto".
  • Ingresar URL: https://app.relbase.cl/ecommerce/actualizar-producto/shopify/token relbase/token webhook shopify
  • Versión de la API de Webhook: Selecciona la opción "Versión candidata".
  • Haz clic en el botón "Guardar webhook".
    
    

Notificación 5: Eliminación de Producto

• • Evento: Selecciona la opción "Eliminación del producto".
  • Ingresar URL: https://app.relbase.cl/ecommerce/borrar-producto/shopify/token relbase/token webhook shopify
  • Versión de la API de Webhook: Selecciona la opción "Versión candidata".
  • Haz clic en el botón "Guardar webhook".
    
    

 

Una vez realizada la configuración en Shopify, se puede continuar con Shopify: Configuración Parte 2 (relBase).

 

Si tienes más preguntas o necesitas asistencia adicional, no dudes en contactarnos a través de contacto@relbase.cl.