Integración con Shopify
Si tienes una tienda en Shopify, FacturaDirecta puede crear automáticamente las facturas de tus pedidos mediante la app de FacturaDirecta para Shopify, instalada dentro del panel de administración de Shopify.
El flujo completo tiene tres partes:
Generas la URL de instalación desde FacturaDirecta.
Instalas la app en Shopify.
Conectas la app con tu cuenta de FacturaDirecta usando una API key y el identificador de empresa.
La integración está disponible para los planes Básico, Avanzado y Total.
Antes de empezar
Necesitas tener creada una tienda en Shopify. La app se configura desde la zona de administración de la tienda, aunque la URL de instalación se genera desde FacturaDirecta.
También necesitarás después:
una API key de FacturaDirecta;
el identificador de tu empresa en FacturaDirecta;
acceso al panel de administración de Shopify.
Generar la URL de instalación en FacturaDirecta
Este paso se realiza desde la pantalla de configuración de Shopify en Ajustes. Si necesitas solo esa parte del flujo, consulta también Shopify en Ajustes.
Entra en Ajustes → API e Integraciones → Shopify.
Pulsa Obtener la URL de instalación.
En el diálogo Indica la URL de tu tienda en Shopify, escribe el subdominio de tu tienda.
El campo tiene el formato https://nombre.myshopify.com: solo rellenas la parte nombre. El botón Generar URL de instalación se activa cuando la URL es válida.
Al pulsar Generar URL de instalación, FacturaDirecta construye una URL única para instalar la app en esa tienda.
Cuando la URL está lista, verás el mensaje La URL de instalación se ha generado correctamente y estas acciones:
Copiar URL — copia el enlace al portapapeles para usarlo más tarde o enviarlo a la persona que gestione Shopify.
Instalar — abre Shopify para iniciar la instalación inmediatamente.
Cerrar — cierra el diálogo.
Instalar la app en Shopify
Pulsa Instalar o abre la URL copiada. Shopify te llevará al flujo de instalación de la app de FacturaDirecta.
Confirma la instalación desde Shopify. A partir de ahí, la configuración detallada de pedidos y facturas se hace desde la app dentro de Shopify.
Crear una API key en FacturaDirecta
Una vez instalada la app, necesitas conectar Shopify con tu cuenta de FacturaDirecta. Para eso, crea una API key desde Ajustes → API e Integraciones → API keys.
Crea una clave nueva y selecciona los permisos necesarios para que la app pueda crear facturas y gestionar los datos implicados en los pedidos.
Al crear la clave, FacturaDirecta la muestra una sola vez. Cópiala y guárdala en un lugar seguro antes de cerrar el diálogo. Si la pierdes, tendrás que crear una nueva.
Obtener el identificador de empresa
Además de la API key, la app de Shopify necesita el identificador de tu empresa en FacturaDirecta. Lo verás en la misma página de API keys.
Copia ese identificador junto con la API key para completar la conexión en Shopify.
Conectar Shopify con FacturaDirecta
Vuelve a la app de FacturaDirecta dentro del panel de Shopify. Introduce:
el identificador de empresa de FacturaDirecta;
la API key que acabas de crear.
Después pulsa Conectar.
Shopify confirmará la conexión cuando los datos sean correctos.
Configurar cómo se crean las facturas
Tras conectar la app, Shopify muestra opciones para controlar cómo se crean las facturas en FacturaDirecta.
Las opciones principales son:
Banco — si eliges un banco de FacturaDirecta, las facturas creadas desde Shopify se marcarán como pagadas en ese banco. Si no eliges ninguno, quedarán pendientes de confirmar el pago.
Serie — indica en qué serie se crearán las facturas. Puedes usar patrones como
##o####para el año, igual que en las series de FacturaDirecta.Crear factura como provisional — si marcas esta opción, los pedidos crean facturas provisionales.
Enviar la factura al cliente — si marcas esta opción, FacturaDirecta envía la factura por correo al cliente. Solo se puede activar si la factura se crea como definitiva.
A partir de ese momento, cada nuevo pedido de Shopify puede generar su factura en FacturaDirecta según esta configuración.
Probar la integración con pedidos antiguos
No necesitas esperar a que llegue un pedido nuevo para probar la app. Desde la página Pedidos de la aplicación FacturaDirecta en Shopify, pulsa Importar pedidos.
La app carga hasta 50 pedidos de los últimos 60 días.
Pulsa el número de pedido para abrir su detalle. Desde ahí puedes enviarlo a FacturaDirecta para crear la factura.
Tras enviar el pedido, la sección Intentos de sincronización muestra el resultado y, cuando se crea correctamente, un enlace a la factura en FacturaDirecta.
Nota sobre el NIF de los clientes
Shopify no siempre solicita el NIF a los clientes. La integración busca un NIF español válido en los datos de dirección del pedido. Si el cliente ha escrito su NIF en alguno de esos campos, FacturaDirecta puede identificarlo y crear el cliente con ese NIF.
Seguridad de la API key
La API key da acceso a los datos permitidos por sus permisos. No la compartas fuera del uso previsto para la app de Shopify.
Si sospechas que la clave se ha filtrado o ya no usas la integración, bórrala y crea una nueva si necesitas reconectar la app.
Recursos relacionados
Shopify en Ajustes — generar la URL de instalación desde FacturaDirecta.
API keys — crear y gestionar claves de la API.
Series de facturas, presupuestos y albaranes — para las facturas que llegan de Shopify suele convenir tener una serie dedicada que facilite identificarlas en los listados.