Integración con Holded
Holded es una plataforma de gestión empresarial todo-en-uno diseñada principalmente para el mercado español (ES), con soporte adicional para Portugal, Italia, Francia y Alemania. Cuando está configurada en CADENSA, puedes emitir facturas legalmente válidas directamente desde tus entradas de tiempo registradas, compatibles con el estándar de e-facturación español FacturaE.
Holded está diseñado principalmente para empresas en España 🇪🇸, con soporte adicional para Portugal 🇵🇹, Italia 🇮🇹, Francia 🇫🇷 y Alemania 🇩🇪.
España exige registros de control horario desde 2019 (Real Decreto-ley 8/2019). El seguimiento del tiempo de CADENSA combinado con la facturación de Holded proporciona un flujo de trabajo completo registro de tiempo → factura para empresas españolas.
Antes de Comenzar
Necesitas:
- Una cuenta activa de Holded (cualquier plan de pago)
- Una clave API de Holded (ver más abajo)
- Unidad CADENSA con al menos el rol de Administrador
Paso 1 — Obtener tu Clave API de Holded
- Inicia sesión en app.holded.com
- Ve a Configuración (icono de engranaje, arriba a la derecha)
- Navega a Integraciones → API
- Haz clic en "+ Nueva Clave API" (o copia una clave existente)
- Copia la clave generada
Nunca compartas tu clave API ni la incluyas en sistemas de control de versiones. Cualquier persona con la clave puede crear y gestionar facturas y contactos en tu nombre.
Para la documentación oficial de la API de Holded, consulta: developers.holded.com/reference
Paso 2 — Configurar en CADENSA
- Abre Configuración → Factura en CADENSA
- Selecciona Holded 🇪🇸 como proveedor
- Pega tu clave API en el campo Clave API
- Haz clic en Probar Conexión — un
verde confirma que la clave es válida - Haz clic en Guardar
Paso 3 — Configurar Valores Predeterminados
| Configuración | Valor recomendado (ES) | Descripción |
|---|---|---|
| Moneda Predeterminada | EUR | Moneda usada en nuevas facturas |
| IVA % Predeterminado | 21 | IVA español estándar (impuesto sobre el valor añadido) |
| Días de Plazo de Pago | 30 | Días hasta la fecha de vencimiento |
| Tipo de Documento Predeterminado | Factura | Preselecciona "Factura" en el diálogo |
| País del Emisor | ES | País de tu empresa — activa la sugerencia automática de IVA |
- 21% — Tipo general — mayoría de servicios
- 10% — Tipo reducido — hostelería, transporte, algunos alimentos
- 4% — Tipo superreducido — libros, medicamentos, algunos alimentos
- 0% — Exento — suministro intra-UE, exportación, ciertos servicios financieros
Emitir una Factura vía Holded
Una vez configurado, sigue el flujo estándar de generación de facturas:
- Abre Informes → aplica filtros de rango de fechas y proyectos
- Haz clic en Generar Factura
- En el campo Tipo de Documento, selecciona Factura — el canal de salida muestra
Holded - Rellena los datos del cliente (nombre, dirección, país, número de IVA/NIF)
- Establece el tipo de IVA (predeterminado: 21%)
- Haz clic en Previsualizar Factura → revisa las partidas y totales
- Haz clic en Emitir Factura (Holded)
CADENSA envía la factura a la API de Holded. Se busca o crea automáticamente un registro de contacto (primero por NIF, luego por nombre). La factura se crea y el PDF está disponible para su descarga.
- Se crea una nueva factura en Holded bajo Facturación → Facturas emitidas
- Se crea automáticamente un contacto si no se encuentra
- El PDF de la factura está disponible para descarga inmediata
Coincidencia de Contactos
CADENSA busca un contacto existente en Holded en este orden:
- Por NIF/número de IVA — coincidencia más fiable (introduce el NIF del cliente en el diálogo de factura)
- Por nombre de empresa — coincidencia exacta (sin distinción de mayúsculas/minúsculas)
- Crear nuevo — si no se encuentra coincidencia, se crea automáticamente un nuevo contacto
Para clientes españoles, introduce siempre el NIF/CIF (p. ej., B12345678) en el campo de NIF del cliente. Esto garantiza que se encuentre el contacto correcto en Holded aunque el nombre de la empresa varíe ligeramente.
Selector de Socios
Cuando Holded está configurado como proveedor de facturas, el diálogo Generar Factura muestra un selector de socios — un desplegable de búsqueda con tus contactos de Holded.
Cómo funciona:
- Escribe un nombre o texto parcial para buscar en tus contactos de Holded en tiempo real
- Seleccionar un socio rellena automáticamente todos los campos del cliente: nombre de empresa, dirección, código postal, ciudad, país, NIF
- El campo de país muestra el nombre original de Holded (p. ej., "Spain", "Hungary") para fácil reconocimiento — mientras que el código ISO subyacente (p. ej.,
ES,HU) se usa para el cálculo de IVA y la lógica de inversión del sujeto pasivo
Flujos de trabajo admitidos:
- Selecciona un socio existente → todos los campos se rellenan automáticamente
- Borra el socio → edita los campos manualmente
- Introduce los datos del cliente manualmente si el socio no está en Holded todavía (se creará un nuevo contacto al emitir la factura)
Mapeo de Tipos de IVA
Holded usa objetos de impuesto nombrados. CADENSA mapea automáticamente tu tipo impositivo numérico:
| Tipo Impositivo | Nombre en Holded | Caso de uso |
|---|---|---|
| 21% | IVA 21% | IVA español estándar |
| 10% | IVA 10% | Tipo reducido |
| 4% | IVA 4% | Tipo superreducido |
| 0% | Exento | Exento / exportación |
Idiomas de Factura
CADENSA selecciona automáticamente el idioma de la factura según el país del emisor:
| País del Emisor | Idioma de Factura |
|---|---|
| ES | Español (es) |
| FR | Francés (fr) |
| DE | Alemán (de) |
| PT | Portugués (pt) |
| IT | Italiano (it) |
| Otros | Español (es, predeterminado) |
Enrutamiento de Documentos
| Tipo de Documento | Salida |
|---|---|
| Proforma | PDF interno (nunca enviado a Holded) |
| Resumen de Trabajo | PDF interno (nunca enviado a Holded) |
| Factura | Enviado a API de Holded → PDF devuelto |
Historial de Facturas y Descarga de PDF
Tras la creación exitosa de una factura:
- La factura aparece en Informes → Facturas en CADENSA
- La factura también aparece en tu cuenta de Holded bajo Facturación → Facturas emitidas
- Puedes volver a descargar el PDF en cualquier momento desde cualquiera de los dos lugares
Resolución de Problemas
Error "401 Unauthorized" / "403 Forbidden"
La clave API no es válida, ha expirado o carece de los permisos necesarios.
Solución: Genera una nueva clave API en Holded (Configuración → Integraciones → API) e introdúcela de nuevo en CADENSA.
Error "INVOICE_NO_ENTRIES"
No se encontraron entradas de tiempo para el rango de fechas y los filtros de proyecto seleccionados.
Solución: Ajusta el rango de fechas o el filtro de proyecto e inténtalo de nuevo.
Contacto no creado / contacto incorrecto asignado
Si falta el NIF y el nombre de empresa no coincide exactamente con un contacto existente en Holded, puede crearse un duplicado.
Solución: Comprueba Contactos en Holded y fusiona los registros duplicados. Para futuras facturas, introduce siempre el NIF/CIF del cliente en el campo de NIF.
La descarga del PDF falla
Holded genera PDFs de forma síncrona — el PDF debería estar disponible inmediatamente tras la creación de la factura.
Solución: Vuelve a descargar desde Informes → Facturas. Si el problema persiste, comprueba la página de estado de Holded o contacta con el soporte de Holded.
La anulación de la factura falla
Solo las facturas en estado pending o draft pueden anularse. Las facturas pagadas no pueden revertirse a través de la API.
Solución: Anula la factura manualmente en Holded (Facturas emitidas → ⋯ → Anular) si la llamada a la API falla.
Ver También
- Configuración del Proveedor de Facturas — Visión general de todos los proveedores
- Generación de Facturas — Cómo crear facturas a partir de entradas de tiempo
- Historial de Facturas — Ver y volver a descargar facturas anteriores