Cómo conectar Holded con Shopify: facturación automática en 5 pasos

Qué necesitas antes de conectar Holded con Shopify

Para establecer la conexión entre Holded y Shopify, requieres acceso administrativo en ambas plataformas. En Shopify, asegúrate de tener permisos para instalar aplicaciones. En Holded, necesitarás acceso a la sección de "Integraciones" o "Configuración avanzada".

Verifica que tu plan en Holded sea compatible con integraciones. Los planes "Emprendedor" (desde 8€/mes en España) incluyen APIs básicas, pero planes como "Profesional" (desde 24€/mes) ofrecen webhooks ilimitados y sincronización bidireccional. En Shopify, cualquier plan (Basic, Shopify, Advanced) permite integraciones.

También necesitarás:

- Clave API de Shopify (se genera desde Panel de administración > Configuración > Apps y canales de ventas) - Token de acceso de Holded (se obtiene en Holded > Configuración > API) - Una conexión de internet estable - Conocimiento básico de JSON (opcional, pero útil para resolver errores de mapeo)

Si tu tienda Shopify tiene más de 10 productos con SKUs variados, dedica 30 minutos a revisar cómo Holded mapea tus categorías de productos. Esto evitará conflictos de sincronización después.

Pasos para instalar la integración Holded-Shopify

**Paso 1: Accede a la App Store de Shopify**

Desde tu panel de administración de Shopify, ve a "Apps y canales de ventas" en el menú izquierdo. Busca "Holded" o "Facturación automática Holded". Las aplicaciones oficiales muestran el logo verificado de Holded.

**Paso 2: Instala la aplicación**

Haz clic en "Agregar aplicación". Shopify te pedirá confirmar permisos: lectura de pedidos, escritura de transacciones, acceso a clientes. Confirma estos permisos, que son necesarios para que Holded lea cada venta.

**Paso 3: Autentica tu cuenta Holded**

La aplicación te redirigirá a Holded. Inicia sesión con tus credenciales. Se te pedirá autorizar que la app acceda a tu información de facturas y clientes. Acepta y la integración se activará.

**Paso 4: Configura el webhook (sincronización en tiempo real)**

En Holded, ve a "Configuración > Webhooks". Crea un nuevo webhook que escuche eventos "Pedido creado" y "Pedido actualizado". Esto hace que cada venta en Shopify genere automáticamente un documento en Holded en segundos, no en horas.

**Paso 5: Realiza una prueba**

Crea un pedido de prueba en Shopify (puedes usar tu propia cuenta de correo con un producto de prueba de 1€). Verifica que aparezca en Holded dentro de 2-3 minutos. Si no aparece, revisa los logs de webhooks en Holded (Configuración > Historial de APIs).

Configuración de mapeos y sincronización de datos

Una vez instalada, la integración sincroniza automáticamente:

- **Datos de clientes**: nombre, email, dirección de envío y facturación - **Productos**: nombre, SKU, precio unitario (antes de impuestos) - **Descuentos**: códigos de cupón y descuentos manuales aplicados al pedido - **Impuestos**: tasa de IVA según país de envío (crucial en España y UE)

**Mapeo de categorías de productos**

En Holded, cada producto debe asignarse a una categoría contable. Si vendes ropa (IVA 21%) y servicios digitales (IVA 21% en España, pero 0% en algunos casos LatAm), configura estas categorías en Holded primero. Luego, en la integración, mapea tus colecciones de Shopify a categorías de Holded. Esto automatizan la clasificación de ingresos.

**Sincronización de impuestos**

Holded respeta el cálculo de IVA que Shopify reporta. Si tu cliente en Barcelona compra 100€ de productos, Shopify calcula 21€ de IVA. Holded recibe exactamente esa cifra y la categoriza como "IVA cobrado" (en el modelo 303 de Hacienda). Verifica que tus tasas de IVA en Shopify (Configuración > Impuestos) coincidan con tu legislación local.

**Qué ocurre con los reembolsos**

Si cancelas un pedido en Shopify, Holded genera automáticamente una nota de crédito (abono). En España, aparece como un documento negativo que reduce tu base imponible. Revisa estos abonos mensualmente para asegurar que tu facturación en Holded refleje realmente el dinero recibido.

**Frecuencia de sincronización**

La sincronización ocurre en tiempo real (webhooks) o cada 30 minutos según tu plan Holded. En prácticas, un pedido confirmado en Shopify a las 15:30 aparece facturado en Holded entre las 15:30 y 16:00. Si necesitas sincronización más rápida (cada 5 minutos), contrata soporte premium en Holded (+15€/mes).

Manejo de errores comunes durante la conexión

**"Permiso denegado al crear factura"**

Causa: tu token de API de Holded no tiene permisos de escritura. Solución: ve a Holded > Configuración > Tokens API. Elimina el token actual y genera uno nuevo, asegurándote de seleccionar "Acceso total" o al menos permisos de "Facturas" y "Clientes".

**"El impuesto no coincide entre Shopify y Holded"**

Causa: Shopify calcula IVA en función de la dirección del cliente, pero Holded puede estar configurado con una tarifa fija. Solución: en Shopify, verifica que tus tasas de impuestos reflejen el destino (España 21%, Portugal 23%, México 16%). En Holded, habilita "Sincronización automática de impuestos" en la sección de integraciones.

**"El cliente aparece duplicado en Holded"**

Causa: el mismo cliente realizó dos compras y el sistema creó dos registros en lugar de vincularlos. Solución: esto no ocurre si ambas compras usan el mismo email. Si sucede, accede a Holded > Clientes y fusiona manualmente. Para futuro, asegúrate que Shopify solicite email obligatorio en checkout (Configuración > Checkout).

**"Los descuentos no se restan de la factura"**

Causa: la integración no reconoce descuentos aplicados manualmente en Shopify. Solución: usa códigos de cupón desde la App Store de Shopify (Discount, Privy, Smile). Estos se sincronizan correctamente. Si aplicas descuentos manuales, revisa en Holded si aparecen como "Línea de descuento". Si no, aumenta el nivel de sincronización en la configuración de la app.

**"Webhook no se activa"**

Causa: el webhook está desactivado o la URL es incorrecta. Solución: en Holded, revisa el historial de webhooks (Configuración > Logs). Si ves errores de "timeout" (sin respuesta), contacta a soporte de Holded. Si la URL está inactiva, regenera el webhook desde cero en Holded.

Mejores prácticas y optimización post-integración

**Auditoría inicial de datos**

Después de 1-2 semanas de activar la integración, descarga un reporte de ventas desde Shopify (Analítica > Ventas) y compáralo con el de Holded (Reportes > Ventas por período). Deben coincidir exactamente en cantidad y monto. Si hay diferencias, revisa los errores de webhook en Holded antes de presentar números a tu contador.

**Reconciliación bancaria**

Holded y Shopify no sincronizan directamente pagos bancarios. Debes vincular tu banco a través de la sección "Cuentas de banco" en Holded (funciona con Stripe, PayPal, transferencias bancarias en España vía Redsys o Sabadell). Una vez vinculado, Holded compara automáticamente facturas emitidas con cobros reales, alertándote si hay pedidos no pagados.

**Seguridad y backups**

Guarda una copia mensual de tus facturas desde Holded en formato PDF (Reportes > Exportar). Aunque Holded tiene servidores redundantes en UE (cumple RGPD), es buena práctica tener evidencia de tus documentos localmente. En Shopify, Holded nunca accede a datos de pago (Shopify + Stripe mantienen eso separado).

**Escalado: múltiples canales de venta**

Si además de Shopify vendes por Marketplace (Mercado Libre, Amazon, etc.), solo Shopify se conecta automáticamente a Holded. Para otros canales, usa Zapier o Make (antiguo Integromat) como intermediario: Marketplace → Zapier → Holded. Esto añade ~5€/mes pero mantiene un único libro contable.

**Revisión trimestral de configuración**

Cada 3 meses, revisa: (1) cambios en tus tasas de IVA, (2) nuevas categorías de productos agregadas a Shopify, (3) cambios en estructura de clientes. Actualiza los mapeos en la integración para mantener la sincronización limpia. Si tu negocio crece de 50 a 500 pedidos/mes, considera habilitar sincronización horaria en lugar de diaria (configurable en Holded > Integraciones).