Cómo crear la clave de Holded
Para que Claude o ChatGPT trabajen con los datos de una empresa, el conector necesita una clave de Holded (Holded la llama API Token). Es como una llave que solo abre las partes de Holded que tú elijas. No es tu contraseña y la puedes anular cuando quieras.
Tardas unos 3 minutos. Al final tendrás un código que empieza por pat_ y que pegarás en la ventana de conexión.
Antes de empezar
- Entra en el Holded de la empresa que quieres conectar. Cada empresa tiene su propia clave. Si eres una asesoría, la clave de tu asesoría solo da acceso a tus propios datos, no a los de tus clientes (mira la guía para asesorías).
- Necesitas acceso al apartado «Desarrolladores». Lo tienen el propietario, los administradores y el rol «Desarrollador». Si no ves ese apartado, pide a quien gestiona la cuenta que te dé ese permiso o que cree la clave por ti.
- La empresa necesita su propia licencia de Holded. En las empresas gestionadas por una asesoría sin licencia propia, es posible que «Desarrolladores» solo muestre «Webhooks» y no se pueda crear la clave.
- Las claves antiguas (32 letras y números, sin
pat_) ya no sirven: el conector solo usa las claves nuevas.
Paso a paso
- 1
Abre Configuración → Desarrolladores → Credenciales
En Holded, abre el menú de tu cuenta (arriba a la izquierda) y entra en Configuración. Busca la sección Desarrolladores y pulsa Credenciales.
Holded · ConfiguraciónMenú de tu cuenta (arriba a la izquierda)
Configuración
Desarrolladores
Credenciales Webhooks
Esquema orientativo con los nombres que verás en Holded. Las capturas oficiales están en Holded Academy. - 2
Pulsa «+ Agregar API Token» y ponle un nombre
Pulsa + Agregar API Token. Ponle un nombre que te ayude a reconocerla después, por ejemplo «Claude y ChatGPT (Isaak)».
Si ves un aviso para ir a las «Api Keys v1», no lo uses: esas son las claves antiguas.
Holded · Configuración › Desarrolladores › CredencialesAPI Tokens
+ Agregar API TokenNombre
Claude y ChatGPT (Isaak)
Esquema orientativo con los nombres que verás en Holded. Las capturas oficiales están en Holded Academy. - 3
Permisos: elige «Por áreas» y marca cada área
En Permisos elige Por áreas. Para cada área, Holded te deja elegir entre Ninguno, Leer, Escribir y Full. Qué poner en cada una está en la tabla de abajo.
Dentro de algunas áreas puedes afinar por apartado (por ejemplo, en Cuenta → «Información de la cuenta»). Si no quieres complicarte, elige el nivel para el área entera.
Holded · Nuevo API Token › Permisos › Por áreasCuentaLeerVentasFullContabilidadFullContactosFullBandeja de entradaFullSistemaLeerDesarrolladoresLeerEquipo, Inventario, Proyectos…NingunoEsquema orientativo con los nombres que verás en Holded. Las capturas oficiales están en Holded Academy. - 4
Pulsa «Crear Token» y cópialo en esa misma ventana
Pulsa Crear Token. Holded te enseña la clave completa una sola vez: pulsa el botón de copiar en esa misma ventana.
La clave completa empieza por
pat_y es larga. En la lista de Holded después solo se ve el principio: si la copias de ahí, estará incompleta y no funcionará.Holded · Nuevo API TokenTu API Token:
pat_••••••••••••••••••••••••••••Copiar
Solo se muestra completo ahora. Cópialo antes de cerrar.
Esquema orientativo con los nombres que verás en Holded. Las capturas oficiales están en Holded Academy. - 5
Pégala en la ventana de conexión
Vuelve a la ventana de conexión (la que se abre desde Claude, ChatGPT o tu panel de isaak.pro) y pega la clave. Comprobamos con Holded a qué empresa pertenece y te enseñamos su nombre y CIF antes de autorizar.
Si falta algún permiso, te diremos exactamente cuál (por ejemplo «Ventas → Facturas: Leer»). Editas la clave en Holded, lo corriges y vuelves a probar.
Qué permisos marcar y para qué sirve cada uno
Elige la columna según lo que quieras que haga el asistente. Con «Solo consultar» el asistente no puede crear ni modificar nada en Holded.
| Área de Holded | Solo consultar | Consultar y crear | Para qué sirve |
|---|---|---|---|
| Cuenta → Información de la cuentaobligatorio | Leer | Leer | Saber a qué empresa pertenece la clave (nombre y CIF). Sin esto no podemos distinguir una empresa de otra. |
| Ventasobligatorio | Leer | Full | Facturas, rectificativas, presupuestos, proformas y tickets. Con «Full», además: crear borradores, enviarlos por email y registrar cobros. |
| Contabilidadobligatorio | Leer | Full | Compras y gastos, plan de cuentas, libro diario, bancos y movimientos, pagos, impuestos y remesas. Con «Full», además: registrar compras y crear asientos. |
| Contactosobligatorio | Leer | Full | Clientes y proveedores. Con «Full», además: darlos de alta o actualizarlos. |
| Bandeja de entrada | Leer | Full | Documentos pendientes de contabilizar. Con «Full», además: subir tickets o facturas y convertirlos en gasto. |
| Sistemaopcional | Leer | Leer | Series de numeración (para que los borradores de factura usen la serie correcta). Recomendado. |
| Desarrolladores → Usoopcional | Leer | Leer | Ver cuántas llamadas a la API lleva la empresa este mes, para avisarte antes de agotar el cupo. |
| Equipo, Inventario, Proyectos, CRM, Suscripción y Partners | Ninguno | Ninguno | El conector no los usa. Déjalos en «Ninguno»: cuanto menos permisos, más segura es la clave. |
Importante: «Escribir» no incluye «Leer»
En Holded, un área en Escribir permite crear, pero no consultar. Si quieres que el asistente consulte y también cree en un área, elige Full, nunca solo «Escribir».
Ejemplo: con Ventas en «Escribir», el asistente podría crear un borrador de factura, pero no listar tus facturas ni comprobar si ya existe.
Lo mínimo para conectar
Para que la conexión funcione hacen falta, como mínimo: Cuenta en Leer y lectura de facturas (Ventas), contactos y plan de cuentas (Contabilidad). El resto depende de lo que quieras hacer.
Aunque marques «Full», el asistente nunca borra nada
El conector no tiene herramientas para borrar, no aprueba documentos y no mueve dinero. Todo lo que crea (borradores, contactos, asientos) te lo pide confirmar antes en la conversación.
Después: cambiar permisos, revocar y seguridad
- Cambiar permisos: en Holded, edita la clave, cambia los niveles y guarda. La clave sigue siendo la misma: no hace falta volver a conectarla.
- Quitar el acceso: borra la clave en Holded (Credenciales) o desconecta la empresa desde tu panel de conexiones. También puedes revocar solo la autorización de Claude o ChatGPT.
- Trátala como una contraseña: no la mandes por chat ni por email sin cifrar, y no la pegues en ningún sitio que no sea la ventana de conexión. Nosotros la guardamos cifrada y nunca se la pasamos a Claude ni a ChatGPT.
- Una clave por uso: si la clave se filtra, bórrala en Holded y crea otra. Al usar claves distintas para cada integración, puedes anular una sin afectar a las demás.
Guía oficial de Holded, con capturas de pantalla: Cómo generar y usar la API de Holded (Holded Academy).