Integración con Shopify

En este artículo aprenderás a hacer la integración iPos-Shopify, así podrás sincronizar tus productos y ventas a este ecommerce.

Configuración dentro de Shopify.

1. Dentro de nuestra cuenta de Shopify iremos a la sección de "Settings", ubicada en la parte inferior izquierda de la pantalla.


Screenshot_1-May-21-2024-07-54-27-1716-PM

2. Dentro de esta sección iremos a "Apps and Sales Channels".

Screenshot_1-May-21-2024-07-47-51-1375-PM

3. Posteriormente daremos clic en "Develop apps".

Screenshot_1-May-21-2024-07-53-29-7024-PM

4. Y daremos clic en "Create an app".

Screenshot_1-May-21-2024-07-58-16-5917-PM

5. En esta pantalla asignaremos el nombre de la app a crear, y daremos clic nuevamente en "Create App".

Screenshot_1-May-21-2024-08-16-38-4892-PM

6. En esta pantalla veremos las configuraciones de esta app, donde configuraremos como primer paso las API, dando clic en el botón de "Configure Admin API scopes".

Screenshot_1-May-21-2024-08-20-22-4390-PM

7. A continuación, elegiremos los siguientes Scopes, asegurándonos de seleccionar todos los que se comparten en esta lista.

- Read_customers (Dentro de Customers)

- Read_inventory (Dentro de Inventory)

- Write_inventory (Dentro de Inventory)

- Read_locations (Dentro de Locations)

- Read_metaobject_definitions (Dentro de Metaobject Definitions)

- Write_metaobject_definitions (Dentro de Metaobject Definitions)

- Read_orders (Dentro de Orders)

- Read_products (Dentro de Products)

- Write_products (Dentro de Products)

En la siguiente imagen podrás ver un ejemplo de como encontrar y seleccionar los scopes, posterior a elegir todos los anteriormente mencionados, es necesario dar clic en el botón de "Save".

Screenshot_1-May-21-2024-08-43-33-3925-PM

8. Una vez hayamos guardado los cambios daremos clic en "API credentials", y daremos clic en "Install app".Screenshot_1-May-21-2024-08-46-37-8262-PM

9. Nuevamente daremos clic en el botón "Install", que aparece en la nueva pantalla.

Screenshot_1-May-21-2024-08-51-30-3148-PM

10. En la nueva pantalla aprecerá el token, el cual es necesario que copies y pegues en algún editor de textos para tenerlo a la mano, es muy necesario este paso, ya que Shopify, solo te muestra este mismo una sola vez. Este los vemos al dar clic en el botón de "Reveal token once"

Screenshot_1-May-21-2024-08-59-33-3354-PM

11. En esta misma pantalla, en la parte inferior encontraremos las API Key y la Secret Key, de igual manera como recomendación es necesario que copies y pegues en algún editor de textos para tenerlo a la mano. Para visualizar la API Secret Key,es preciso seleccionar el botón con el ícono del ojo y luego copiar la misma.

Screenshot_1-May-21-2024-09-06-40-6382-PM

12. Posteriormente iremos a la sección "App Settings", donde opcionalmente ingresaremos el siguiente email (hola@ipos.mx) para que nos llegue cualquier información relevante a tu tienda. Y daremos clin en "Save"

Screenshot_1-Jun-04-2024-06-53-04-0786-PM

Configuración en iPos.

1. Una vez que terminemos los pasos anteriores en Shopify, dentro del sistema iPos. Iremos a Ajustes/Online Shop Integraciones/Integraciones
Screenshot_1-Jun-04-2024-06-59-44-0332-PM
2. Daremos clic en "Agregar".
Screenshot_1-Jun-04-2024-07-02-59-1282-PM
3. Luego procederemos a seleccionar la opción para agregar una Integración de tipo Shopify, eligiendo esta misma de entre las opciones disponibles.

Screenshot_1-Jun-04-2024-07-05-05-3377-PM
4. En la pantalla que aparece, ingresaremos las claves que guardamos anteriormente en algún editor de textos y daremos clic en "Probar conexión y activar". Screenshot_1-Jun-04-2024-07-16-29-0984-PM

El nombre de la tienda (store name), lo encontrarás en Shopify, en la sección de configuración en la parte superior de las opciones de ajustes, en este caso es: "iposmx", justo el nombre que se encuentra antes del ".myshopify.com". Ese será el nombre a colocar en el campo del Store Name.

Screenshot_1-Jun-04-2024-07-22-06-6728-PM
5. Si los pasos anteriores fueron realizados de manera correcta, aparecerá la siguiente pantalla donde veremos las configuraciones de la integracion iPos + Shopify.

Información General.


Podrás ver tu API Key, Secret Key, Store name de la integración creada

- Status: Indica si está o no activo.
- Nombre: Indica el nombre de la integración.
- Nombre Variante: Aplica cuando no se separan los atributos o no hay etiquetas de variante en el producto. Si no quieres que aparezca nada, escribe la palabra "Default".
- Webhook Signature:

Configuración 

- ¿Separar Atributos?: Separá como productos nuevos las variantes de tus productos.
- Formato variante: Selecciona los formatos de las variantes a mostrar de tus productos
- Tags de productos: Selecciona los tags a mostrar de tus productos
- ¿Enviar Campos Extra de Variantes como Meta Fields?: Al habilitar esta opción, los campos adicionales de tus variantes se enviarán como meta fields.
- ¿Sincronizar fotos de producto?: Al activarlo, cada vez que se haga un cambio en las fotos de los productos, se hará la sincronización automática de las mismas hacia Shopify. Si se sincroniza a través del módulo Online Shop/Sincronizar siempre se enviarán las fotos de producto.
- ¿Sincronizar títulos de variante?: Al activarlo, cada vez que se haga un cambio en los productos, se hará la sincronización automática mandando los títulos de los de variante a Shopify, en caso de que no esté activo, únicamente se mandarán los valores, sin afectar los títulos.
- ¿Enviar correo para auto facturación?: Se enviará un correo al cliente con el enlace para generar la auto facturación (siempre y cuando tengas activada esta opción en iPos).
- Proveedor:
Elige si quieres mantener el proveedor de tus productos como los tienes en el catalogo o elige con cual quieres que se sincronicen en esta aplicación. Esto funciona por si no quieres que en la aplicación se vea el nombre real del proveedor.
- Marca: Elige si quieres mantener la marca de tus productos como los tienes en el catalogo o elige con cual quieres que se sincronicen en esta aplicación. Esto funciona por si no quieres que en la aplicación se vea el nombre real de la marca.
-Tipo de cliente:
Elige el tipo de cliente con el que quieres que se registren en iPos los nuevos clientes que compren en esta aplicación.
- ¿Cambiar template según categoría?: Al activarlo cambiaría el template por categorías. 

Screenshot_1-Jun-04-2024-10-35-11-0121-PM

Almacenes / Canales de Venta

- Almacén / Canal Principal: Selecciona el almacén/canal de venta principal donde se verán reflejadas las ventas de la aplicación

- Almacenes / Canales Secundarios: Suma al inventario de Shopify de otros almacenes o canales.
- ¿Dividir inventarios por almacenes?: Separar los inventarios por almacenes o canales de venta.
- Actualizar Inventarios: Es un botón para confirmar la actualización de los inventarios seleccionados.Screenshot_1-Jun-04-2024-11-05-18-0946-PM

Webhooks.

Screenshot_1-Jun-18-2024-05-47-00-3469-PM

Estos se van a tener que configurar del lado de Shopify, para esto realizaremos los siguientes pasos:

1. Dentro de la sección "Setting/Ajustes" en Shopify, iremos a la sección de "Notifications" y posteriormente daremos clic en "Webhooks".

Screenshot_1-Jun-18-2024-05-43-28-1210-PM

2. Una vez dentro de la nueva pantalla daremos clic en "Create webhook"  (necesitamos crear todos los Webhooks del listado de iPos).

Para esto seleccionaremos el evento del Webhook a agregar haciendo que coincida el nombre del evento en Shopify con el de iPos, para este ejemplo tomaremos el de "Nueva venta" en iPos, entonces dentro de Shopify buscaremos ese, que en este caso es "Order creation". Y en el formato seleccionaremos el que lleva por nombre "JSON"

Screenshot_1-Jun-18-2024-06-03-31-8617-PM

Posteriormente, copiaremos el link del Webhook de iPos.

Screenshot_1-Jun-18-2024-06-05-36-4956-PM

Y lo pegaremos en el cuadro de URL del Webhook dentro de Shopify.

Screenshot_1-Jun-18-2024-06-07-00-9055-PM
Solo faltará seleccionar el Webhook API Version, donde dentro de las opciones disponibles siempre elegiremos la que lleva por nombre (Latest) sin importar los números que aparecen.

Screenshot_1-Jun-18-2024-06-12-29-1333-PM
Una vez finalicemos de configurar todos estos pasos daremos clic en el botón de "Save"  para guardar esta configuración

Screenshot_1-Jun-18-2024-06-15-38-6393-PM

Recuerda que...

- Debes realizar este proceso para todos los Webhooks en la lista de iPos.

Sincroniza tus Productos / Inventarios

- Sincronizar productos de iPos hacia Shopify: Iniciarás una sincronización de tus productos creados en iPos hacia Shopify, esta también la puedes realizar desde Online Shop/Sincronizar.

- Descarga produtos de Shopify a iPos: Se iniciará el proceso de descarga de los productos que ya están en Shopify hacia iPos.
- Descargar colecciones de Shopify a iPos como tags: Descargará las colecciones de tus productos como etiquetas.

- Descargar metafields de productos de Shopify a iPos como campos extra: Descargará los metafields de tus productos como campos extra de los mismos.

Si te surge alguna pregunta o requieres asistencia, no dudes en contactarnos a través del chat de soporte. Estamos aquí para atenderte con amabilidad y ofrecerte respuestas efectivas a tus inquietudes.