Integración de Shopify con TicketBAI y Verifactu
Factura automáticamente los pedidos de tu tienda Shopify y las ventas de Shopify POS, y envíalos a la Hacienda que te corresponde: Araba, Bizkaia (TicketBAI y Batuz LROE), Gipuzkoa o la Agencia Tributaria (Verifactu).
Instala la app de TicketBAI WS desde la Shopify App Store o, si prefieres, conecta tu tienda manualmente mediante webhooks.
Dos formas de conectar tu tienda
App de Shopify
Se instala desde la Shopify App Store y se configura en unos minutos: cuenta, series, diseño de la factura y envío por email. Incluye Shopify POS, rectificativas automáticas y entorno de pruebas gratuito.
Integración por webhooks
Creas tres webhooks en Shopify que envían los pedidos a TicketBAI WS y activas la integración desde tu área privada. Es la integración original, para quien ya la tiene configurada o prefiere hacerlo a mano.
Qué hace la app de TicketBAI WS para Shopify
Factura cada pedido
Pedido sin NIF: factura simplificada. Pedido con NIF: factura completa. Puedes facturar solo los pedidos pagados y desde la fecha que elijas.
Shopify POS
Factura al instante las ventas del TPV e imprime automáticamente el ticket TicketBAI.
Devoluciones y cambios
Emite la rectificativa correspondiente: abono y, si queda importe, una factura nueva.
IVA intracomunitario
Aplica el régimen que corresponde según el país de envío: OSS, exportaciones y clientes de la UE con NIF-IVA.
Envío por email
Envía la factura al cliente con tu propio correo (SMTP, Gmail u Outlook), con copia a la tienda si quieres.
Diseño de la factura
Tu logo, color, tipografía y textos legales en castellano, euskera e inglés, con vista previa al momento.
Instrucciones de integración por webhooks
Si no usas la app, sigue estos pasos para conectar tu tienda Shopify con TicketBAI WS.
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

URL de entrega y clave de firma
En los datos deberemos seleccionar en el desplegable de evento Creación de pedido, el formato JSON, y 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/
En el campo de versión de la API de webhooks, elige la versión marcada como «más reciente» entre paréntesis. Una vez creemos los webhooks, aparecerá una clave de firma aleatoria que deberemos introducir en la configuración de la integración.


Configurar la integración
Activa la integración de Shopify desde el apartado API → Integraciones del menú del área privada, poniendo la URL de la tienda y la clave de firma generada en la configuración de los webhooks.
De momento deja la casilla de activado sin marcar y el entorno TicketBAI en modo TEST. En el campo de URL de la tienda, introduce la dirección privada de la tienda online, con este formato:
mi_tienda.myshopify.com
Introduce la serie que quieres que lleven las facturas (por defecto, la serie A) y elige si usas el campo de dirección 2 de envío de Shopify para el NIF. La casilla «Dejar en estado proforma» hará que todas las facturas queden en proforma y tengan que validarse a mano.

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, crea una app personalizada en Shopify e introduce el código «access_token»: te facilitará crear facturas a mano desde el editor.
Con la app personalizada, las facturas que se crean automáticamente a partir de los pedidos pueden generarse con el HS Code, necesario para envíos extracomunitarios.

Envío automático de las facturas por email
Selecciona el servicio de correo. Con Gmail u Hotmail/Outlook/Office365 solo tendrás que introducir el usuario y la contraseña; con otro proveedor, elige Otros e introduce el servidor SMTP y el puerto. El botón «Probar conexión» te dirá si funciona.
Define el remitente, el asunto, el cuerpo del mensaje, el idioma de la factura y el color de fondo del email. El email lleva el logotipo de la tienda y el PDF de la factura adjunto.
Con «Enviar únicamente las facturas completas», las facturas simplificadas (sin NIF del cliente) no se envían. También puedes enviar una copia de todos los emails a la tienda.

Imprimir el código QR en las facturas
Si quieres mostrar el código QR en la aplicación de facturación que usas ahora, modifica la plantilla de la factura para incluir una imagen enlazada a esta URL, sustituyendo NIF_EMPRESA por el NIF de la empresa. Mostrará el QR y la huella TBAI del pedido.
Ejemplo para la aplicación Order Printer de Shopify, en la parte baja de la plantilla:
<p><img src="https://ticketbaiws.eus/qr-integracion/NIF_EMPRESA/{{ order_name }}/" style="width:60mm" /></p>

Te damos de alta en el entorno de pruebas y te acompañamos en la integración. También tenemos integración con WooCommerce y un API REST para cualquier otro sistema.
