Migración
Exportar información de Holded a través de la API
Con una clave que sacas en dos clics, Cofactu trae tus facturas, gastos, presupuestos y productos de Holded solos. Sin exportar Excel ni copiar nada a mano.
Respuesta directa
Antes de empezar.
Qué vas a resolver.
Exportar información a través de la API de Holded consiste en generar una API key —un código que creas en tu cuenta de Holded— y dársela al programa que va a leer tus datos, en este caso Cofactu. Con esa clave, Cofactu lee tus datos directamente de Holded y los importa —facturas, compras, cobros y pagos, presupuestos y catálogo— sin que tengas que descargar ni subir ningún fichero.
No necesitas saber qué es una API ni tocar nada técnico: es copiar un código de un sitio y pegarlo en otro. El tiempo depende del volumen y de la revisión. Revoca la clave cuando ya no necesites sincronizar.
Esta guía te enseña dónde está la opción en Holded (está algo escondida, en el menú de Desarrolladores), cómo generar la clave y cómo conectarla en Cofactu con seguridad.
Procedimiento
Hazlo en orden.
Abre solo el paso que toca.
6 pasos para revisar, emitir y dejar el documento listo sin leer una guía entera de una vez.
-
01 Entra en el menú de Desarrolladores de Holded
Paso 01: Entra en el menú de Desarrolladores de Holded
En Holded, ve a Configuración (el engranaje) → Más → Desarrolladores. Es la sección donde Holded guarda las API keys; está separada del resto de ajustes precisamente porque no es de uso diario, por eso cuesta encontrarla la primera vez.
- Ruta exacta: Configuración → Más → Desarrolladores → API Keys.
- Necesitas ser administrador de la cuenta; un usuario limitado no ve esta sección.
-
02 Genera una nueva API key
Paso 02: Genera una nueva API key
Pulsa "Nueva API Key", ponle un nombre reconocible (por ejemplo "Cofactu — migración") y créala. Holded te mostrará un código largo. Cópialo entero: es la clave que Cofactu usará para leer tus datos. Guárdalo un momento en un sitio seguro mientras terminas.
-
03 Pega la clave en Cofactu
Paso 03: Pega la clave en Cofactu
En Cofactu, ve a Configuración → Integraciones, elige Holded y pega la API key en el campo de conexión. Al guardar, Cofactu hace una comprobación inmediata contra Holded para validar que la clave funciona; si es correcta, verás la conexión como activa.
-
04 Elige qué quieres importar
Paso 04: Elige qué quieres importar
Cofactu te deja seleccionar qué tipos de documento traer: facturas de venta, compras (gastos), cobros y pagos, presupuestos y productos del catálogo. Marca lo que necesites. Para una migración completa, déjalo todo activado; si solo quieres el catálogo para empezar, marca únicamente productos.
- Facturas de venta y sus cobros.
- Compras (gastos) y sus pagos.
- Presupuestos.
- Catálogo de productos y servicios.
-
05 Lanza la sincronización y revisa
Paso 05: Lanza la sincronización y revisa
Inicia la importación y Cofactu irá trayendo los datos de Holded, mostrándote un resumen de cuántos documentos ha importado, actualizado u omitido de cada tipo. Cuando termine, coteja los totales (número de facturas, suma de bases e IVA) con lo que ves en Holded para confirmar que ha cuadrado.
-
06 Borra la API key en Holded
Paso 06: Borra la API key en Holded
Terminada la migración, vuelve a Holded → Desarrolladores y elimina la API key que creaste. Así cierras el acceso: la clave deja de funcionar y nadie —ni tú— puede volver a leer tus datos con ella. Si más adelante quieres volver a sincronizar, generas una nueva en un minuto.
Preguntas frecuentes
Las dudas que aparecen
al ponerlo en práctica.
01¿Cómo exportar información a través de la API de Holded?
Holded permite dos vías. Por su API —la de esta guía— la exportación es automática: generas una clave y Cofactu lee facturas, compras, cobros y pagos, presupuestos y catálogo directamente, sin ficheros de por medio. La alternativa manual es exportar cada listado a CSV/Excel desde su pantalla correspondiente, y el libro diario desde Contabilidad → Asientos → Exportar; Cofactu también importa ese CSV si prefieres esa vía o si no eres administrador de la cuenta de Holded.
02¿Qué información se puede exportar por la API de Holded?
La API de Holded expone los documentos de facturación (facturas de venta, compras, presupuestos, albaranes y sus cobros y pagos), los contactos, el catálogo de productos y servicios y los asientos contables. Cofactu importa por esta vía facturas, compras, cobros y pagos, presupuestos y catálogo; los contactos se crean al traer sus documentos.
03¿Qué es una API key y es seguro usarla?
Es un código que autoriza a una aplicación (Cofactu) a leer los datos de otra (Holded) en tu nombre. Limita su acceso y trátala como una contraseña: la generas solo para esta conexión, la usas y la borras en Holded al acabar. Cofactu la guarda cifrada mientras esté activa.
04¿No encuentro la opción de Desarrolladores en Holded?
Está en Configuración → Más → Desarrolladores. Si no la ves, comprueba los permisos y la disponibilidad de API en tu plan: pídele a quien la administre que genere la clave, o que te dé permisos de administrador temporalmente.
05¿Se importa todo mi histórico o solo lo reciente?
Cofactu trae los documentos de los tipos que marques (facturas, gastos, presupuestos, productos). Las facturas entran como borradores en una serie de importación. No acreditan la aceptación anterior por la AEAT ni garantizan su inclusión correcta en libros. Conserva los originales y revisa el tratamiento con tu asesor.
06¿Puedo conectar otro programa que no sea Holded?
Sí. Cofactu conecta también con FacturaDirecta y Billage por API key (con alcance propio por conector) y con A3. El proceso es el mismo: sacas la clave en tu programa y la pegas en Configuración → Integraciones de Cofactu.
Siguiente lectura
Continúa desde aquí.
Sin perder el contexto.
Otras guías de Cofactu
De la guía al trabajo real
Ahora puedes hacerlo.
Cofactu puede dejarlo preparado.
Empieza con facturación VeriFactu y mantén documentos, modelos y evidencia dentro del mismo flujo.