Instrucciones integración Tiendas Shopify
1- Creación de Webhooks
Para realizar la integración de Shopify debes hacerlo desde el apartado de Configuración -> Notificaciones -> Webhooks (abajo del todo)
Se deberán crear 3 webhooks:
- Creación de pedido
- Actualización de pedido
- Cancelación de pedido
En los datos deberemos seleccionar en el desplegable de evento Creación de Pedido, el formato JSON, poner en el campo de URL de entrega la siguiente dirección indicando el NIF de la empresa:
https://ticketbaiws.eus/webhooks/MI_CIF/shopify/
Y en el campo de versión de la API de webhooks la versión marcada como "más reciente" entre paréntesis
Una vez creemos los webhooks, aparecerá una clave de firma aleatoria. Esa clave de firma la deberemos introducir en la configuración de la integración:
3- Configurando la integración
Deberemos activar la integración de Shopify desde el apartado de API-> Integraciones del menú del área privada, poniendo la URL de la tienda y la clave de firma que se nos haya generado en la configuración de los webhooks
De momento dejaremos la casilla de activado SIN MARCAR y el Entorno TicketBAI en modo TEST. En el campo de URL de la tienda, deberemos introducir la dirección privada de la tienda online que tiene este formato:
mi_tienda.myshopify.com
Introduciremos la serie que queremos que lleven las facturas que se generen (por defecto la serie A) y podremos seleccionar si utilizamos el campo de dirección 2 de envío en Shopify para el NIF.
La casilla de "Dejar en estado proforma", hará que todas las facturas queden en proforma y tengan que ser validadas a mano.
3.1- Integrar el catálogo de productos de Shopify
Existe la opción de integrar el catálogo de productos de Shopify en el editor de facturas. Para ello, necesitaremos crear una APP personalizada en Shopify e introducir el código "access_token" que nos facilitará el trabajo de crear facturas a mano desde el editor de facturas.
Si se crea la APP Personalizada, existe la opción de que las facturas que se crean de forma automática a partir de los pedidos de Shopify se generen con el HS_Code, necesario para envíos extracomunitarios.
4.1- Configurar el envío automático de las facturas
Puedes configurar que las facturas se envíen de forma automática a tus clientes. Para ello, deberás introducir los datos de la cuenta de correo electrónico desde donde quieres que se envíen las facturas.
Lo primero, selecciona el servicio. Si usas Gmail o Hotmail/Outlook/Office365 seleccionálo en el desplegable y solo tendrás que introducir el usuario y contraseña desde donde quieres que se realicen los envíos. Dispones de un botón de probar conexión que te dirá si la conexión funciona.
Si el correo electrónico que utilizas no es ninguno de esos servicios, selecciona Otros e introduce los datos del servidor SMTP y puerto de tu proveedor de correo electrónico.
Introduce el nombre que aparecerá como remitente, el asunto y el cuerpo del mensaje. Puedes definir el idioma en el que quieres que se envíe la factura y el código de color del fondo del email. Por defecto aparecerá en gris claro. En el email que se envía, aparecerá el logotipo de la tienda que hayas configurado y el fichero PDF de la factura adjunto.
Si activas la casilla de "enviar únicamente las facturas completas", las facturas simplificadas, aquellas que no tienen el NIF del cliente no se enviarán.
Finalmente existe también la opción de enviar una copia de todos los emails a la propia tienda, puede ser útil para comprobar el funcionamiento del sistema o para verificar que el cliente reciba la factura.
4.2- Imprimir el código QR en las facturas
Si lo que deseas es mostrar el código QR directamente en la aplicación de facturación que estás usando en la actualidad, hay que modificar la plantilla de la factura del plugin de generación de facturas incluyendo un sencillo código que hará que salga el QR y la huella TBAI en una imagen. Para ello, hay que meter una imagen que esté enlazada desde la siguiente URL sustituyendo el texto NIF_EMPRESA por el nif de la empresa y el código pedido por el código del pedido para el cual se está generando el QR.
A continuación ponemos el ejemplo de cómo imprimir el código QR en la aplicación Order Printer de Shopify:
Ejemplo de código para la aplicación Order Printer:
Introducir en la configuración de la plantilla en la parte baja de la factura el siguiente código poniendo el NIF de la empresa en cuestión:
<p><img src="https://ticketbaiws.eus/qr-integracion/NIF_EMPRESA/{{ order_name }}/" style="width:60mm" /></p>
