¿Cómo instalar relBase en Shopify?

Para habilitar la integración entre Shopify y relBase, diríjase a su cuenta de Shopify e ir a la opción Aplicaciones.

 

Seleccionar la opción Configuración de aplicaciones y canales de ventas.

Luego ir a la opción Desarrollar aplicaciones para tu tienda.

A continuación, hacer clic en el botón Crear una aplicación.

Ingresar el relBase en el campo Nombre de la aplicación y presionar el botón "Crear aplicación"

A continuación hacer clic en la opción "Configurar alcances de la API del panel de control"

Y modificar solo los siguientes permisos:

• Inventario (Inventory): Leer y escribir / write_inventory y read_inventory
• Sucursales (Locations): Solo lectura / read_locations
• Pedidos (Orders, transactions and fulfillments): Solo lectura / read_orders
• Productos (Products, variants and collections): Solo lectura / read_products

Por último, en la sección "Suscripciones a Webhooks" seleccionar opción 2023-04 y presionar el botón Guardar.

Una vez establecidos los permisos, ir a la pestaña "Credenciales de la API" y presionar el botón "Instalar aplicación"

Shopify mostrará un mensaje de advertencia donde indica que se creará una nueva aplicación que tendrá acceso a la API y datos de la tienda. Hacer clic en el botón Instalar.

Una vez creada la aplicación en Shopify se visualizarán las credenciales que permiten a relBase conectarse a la cuenta de Shopify, estos datos son los solicitados al momento de crear la integración en relBase.

• El campo "Clave api" de Shopify se debe copiar en el campo "Clave api" de la configuración de la integración en relBase.
• El campo "Token de acceso de la API del panel de control" de Shopify se debe copiar en el campo "Contraseña" de la configuración de la integración en relBase.
• El campo "Clave secreta api" de Shopify se debe copiar en el campo "Secreto compartido" de la configuración de la integración en relBase.

Notificaciones

El último paso es configurar la cuenta de Shopify para que informe a relBase cuando se producen nuevos pedidos o creación de productos. Para esto debe ir a la opción del menú lateral Configuración.

Hacer clic en la opción Notificaciones.

Al final de la pantalla, en la sección WebHooks, hacer clic en el botón Crear webhook.

Se deben crear 5 notificaciones:

Pago de pedido:

• Seleccionar en el campo Evento la opción Pago de pedido.
• Ingresar URL: https://app.relbase.cl/ecommerce/procesar-pedido/shopify/<token relbase>/<token webhook shopify> 

La llave del token relBase debe ser suministrada por el equipo de relBase, para ello enviar correo a [e-mail], la llave del token webhook shopify se encuentra en el recuadro marcado en rojo "Todos tus webhooks se firmarán con" de la imagen anterior.

• Seleccionar en el campo Versión de la API de Webhook la opción 2023-04.
• Hacer clic en el botón Guardar webhook.

Cancelación de pedido:

• Seleccionar en el campo Evento la opción Cancelación de pedido.
• Ingresar URL: https://app.relbase.cl/ecommerce/procesar-pedido/shopify/<token relbase>/<token webhook shopify> 
• Seleccionar en el campo Versión de la API de Webhook la opción 2023-04.
• Hacer clic en el botón Guardar webhook.

Creación de producto:

• Seleccionar en el campo Evento la opción Creación de producto.
• Ingresar URL: https://app.relbase.cl/ecommerce/actualizar-producto/shopify/<token relBase>/<token webhook shopify> 
• Seleccionar en el campo Versión de la API de Webhook la opción 2023-04.
• Hacer clic en el botón Guardar webhook.

Actualización de producto:

• Seleccionar en el campo Evento la opción Actualización de producto.
• Ingresar URL: https://app.relbase.cl/ecommerce/actualizar-producto/shopify/<token relBase>/<token webhook shopify>
• Seleccionar en el campo Versión de la API de Webhook la opción 2023-04.
• Hacer clic en el botón Guardar webhook.

Eliminación del producto:

• Seleccionar en el campo Evento la opción Eliminación del producto.
• Ingresar URL: https://app.relbase.cl/ecommerce/borrar-producto/shopify/<token relBase>/<token webhook shopify> 
• Seleccionar en el campo Versión de la API de Webhook la opción 2023-04.
• Hacer clic en el botón Guardar webhook.

 

Una vez creado todos los webhooks, Shopify generará un token que permite a relBase validar que todas las notificaciones recibidas serán efectivamente de la tienda configurada. Este token debe ser copiado y pegado en la configuración del ecommerce en relBase.