Permisos de la clave de Holded para el conector

Qué permisos marcar según lo que quieras hacer

Elige la columna que encaje con tu caso. La tabla se genera a partir de las herramientas reales del conector: cada área está en «Leer» si el asistente solo la consulta y en «Full» si además crea algo en ella (porque en Holded «Escribir» no incluye «Leer»).

Bandeja de entrada y Desarrolladores → Uso son opcionales: sin ellos el conector funciona, pero el asistente no verá los documentos pendientes de contabilizar ni podrá avisarte de cuántas llamadas a la API llevas.

Para conectar la clave hace falta, como mínimo, la lectura de facturas, contactos y plan de cuentas. Marca siempre también Cuenta (Información de la cuenta): sin ella no se puede conectar desde Claude o ChatGPT, no podemos comprobar a qué empresa pertenece la clave y el asistente no puede confirmar con qué empresa trabaja. Si falta algo, la ventana de conexión te dice qué.

Con Ventas en «Full», el asistente también puede enviar por email documentos y registrar cobros: Holded da esas acciones con el mismo permiso que crear. Cada una te la pide confirmar antes.

Para la asesoría, «Full» en todo el área de Contabilidad cubre también las escrituras contables que se añadan más adelante (por ejemplo, conciliar o crear cuentas). Si prefieres el mínimo, usa la tabla por recurso y amplía cuando se activen.

Crear la clave con esos permisos

1. 1

   Abre Configuración → Desarrolladores → Credenciales

   Entra en el Holded de la empresa que quieres conectar (cada empresa tiene su propia clave) con un usuario que vea el apartado «Desarrolladores»: propietario, administrador o rol «Desarrollador». Pulsa + Agregar API Token y ponle un nombre reconocible, por ejemplo «Claude y ChatGPT (Isaak)».

2. 2

   Elige «Permiso por áreas»

   Holded ofrece modos ya hechos («Análisis», de solo lectura, y «Operativo») y «Por áreas». Usa «Por áreas»: los modos ya hechos abren áreas que el conector no usa (CRM, Proyectos, Inventario…) y «Operativo» no incluye la escritura de facturas ni de contabilidad.

   Puedes fijar un permiso global y luego ajustar cada área. Lo más claro: global en «Ninguno» y sube solo las áreas de la tabla.

3. 3

   Marca el nivel de cada área

   Cada área (y cada recurso dentro de ella) admite Ninguno, Leer, Escribir o Full (en algunas pantallas aparecen como «Sin acceso», «Lectura», «Escritura» y «Full»). Copia la columna de tu caso. Si eliges escritura en alguna área, Holded te pedirá escribir «Doy mi consentimiento» para confirmarlo.

4. 4

   Crea el token y cópialo en esa misma ventana

   Pulsa Crear Token y copia la clave completa (empieza por pat_). Holded la muestra entera solo una vez. Más detalle, con esquemas de cada pantalla, en la guía de la clave.

5. 5

   Pégala en isaak.pro

   Pégala en la ventana de conexión (desde Claude, ChatGPT o tu panel). Antes de guardarla comprobamos con Holded a qué empresa pertenece y, si falta algún permiso obligatorio, te decimos cuál.

Cambiar o revocar los permisos después

Subir o bajar permisos: edita la clave

En Holded → Configuración → Desarrolladores → Credenciales, edita la clave, cambia los niveles y guarda. La clave sigue siendo la misma: no tienes que hacer nada en isaak.pro ni volver a conectar Claude o ChatGPT. Los cambios valen desde la siguiente consulta.

Usar otra clave: cámbiala en el panel

Si prefieres crear una clave nueva (por ejemplo, con otros permisos o porque la anterior se ha filtrado):

1. Crea la nueva en Holded, en el Holded de la misma empresa.
2. En isaak.pro, abre Panel → Empresas, entra en la empresa y, en «Conexión con Holded», pulsa Cambiar clave. Solo lo pueden hacer el titular y los administradores de la empresa.
3. Pega la nueva clave. Si tiene el permiso de Cuenta y es de otra empresa (otro CIF), la rechazamos para no mezclar datos: añádela como empresa nueva.
4. Al cambiar la clave, las autorizaciones de Claude y ChatGPT de esa empresa dejan de valer (en el panel aparecen como «Ya no funciona»). Revócalas y vuelve a conectar el asistente.
5. Borra la clave antigua en Holded.

Quitar el acceso

• A todo: borra la clave en Holded. Desde ese momento Holded rechaza cualquier consulta del conector para esa empresa.
• Solo a un asistente: en la ficha de la empresa, «Claude y ChatGPT», revoca su autorización. La clave sigue guardada para los demás.
• Desconectar la empresa de isaak.pro: en la misma ficha, «Conexión con Holded» → desconectar. Borra también la clave en Holded si ya no la vas a usar.

Qué pasa si falta un permiso

Al conectar: si faltan los obligatorios, la ventana de conexión no guarda la clave y muestra el permiso exacto, por ejemplo «Al token de Holded le falta este permiso: Ventas → Facturas: Leer».

Al usar el conector: si el asistente intenta algo para lo que la clave no tiene permiso, Holded lo rechaza y Claude o ChatGPT te muestran un mensaje como este:

Al token de Holded le falta este permiso: Contabilidad → Bancos: Leer. Actívalos en Holded → Configuración → Desarrolladores → Credenciales → editar el token → Permisos «Por áreas» y guarda los cambios. […] No hace falta crear otra clave: la misma sirve en cuanto Holded guarda los permisos. El resto de herramientas siguen funcionando.

Cómo arreglarlo: edita la clave en Holded, pon ese recurso (o su área) en «Leer», o en «Full» si también necesitas crear, guarda y repite la pregunta. Solo falla esa herramienta; el resto sigue funcionando mientras tanto. En la tabla del final ves qué deja de funcionar sin cada permiso.

Si Holded responde que la clave no vale (borrada o anulada), el mensaje es «Holded ha rechazado la clave de esta empresa (borrada o sin permisos)»: crea una nueva y cámbiala en el panel. Más mensajes en Mensajes de error.

Permisos de Holded y permisos de isaak.pro: se suman

Una acción solo se hace si la permiten las tres capas a la vez:

1. La clave de Holded (esta guía): qué deja hacer Holded con esa clave. Es el límite máximo para todos los usuarios de la empresa.
2. Tu rol en isaak.pro, por empresa (Panel → Usuarios): «Solo lectura» consulta pero no crea nada, aunque la clave esté en «Full»; «Acceso completo» consulta y crea borradores o registros con confirmación; «Administrador» además gestiona la empresa (datos, conexiones, equipo).
3. La autorización de Claude o ChatGPT: al conectar el asistente eliges si trabaja solo con esa empresa o con todas las tuyas. Le da acceso a las herramientas del conector y la puedes revocar en cualquier momento desde el panel.

Ejemplo: con la clave en «Full» y un usuario en «Solo lectura», ese usuario no puede crear nada. Con un usuario en «Acceso completo» y la clave en «Leer», tampoco: Holded lo rechaza.

Seguridad

• Mínimo privilegio: marca solo lo que vayas a usar. Si solo vas a consultar, todo en «Leer». Siempre puedes ampliarlo después editando la clave.
• El conector no borra nada: ninguna de sus herramientas borra datos en Holded, ni siquiera con la clave en «Full».
• Cada escritura se confirma: el asistente primero te enseña lo que va a crear o enviar, y solo lo hace cuando confirmas en la conversación. La confirmación vale una sola vez y caduca a los 10 minutos.
• Borradores, salvo que Holded diga otra cosa: los documentos se crean sin aprobar, pero si tu Holded tiene la auto-aprobación activada, o al convertir un documento de la bandeja de entrada, pueden quedar emitidos. El asistente te dice cómo ha quedado.
• La clave no sale de isaak.pro: la guardamos cifrada y nunca se la pasamos a Claude ni a ChatGPT. Trátala como una contraseña y no la mandes por chat.

Todas las herramientas y su permiso

Lista completa de las herramientas del conector, generada desde el código. Las marcadas con † se han deducido del nombre del recurso en la API de Holded y están pendientes de comprobar con una clave real.

Preguntas frecuentes

¿Por qué «Full» y no «Escribir»?

Porque en Holded «Escribir» deja crear pero no consultar. El asistente necesita leer lo que va a crear (el cliente, la serie, si ya existe), así que para escribir hace falta «Full».

¿Tengo que volver a conectar si cambio los permisos?

No, si editas la misma clave en Holded. Sí, si la cambias por otra: entonces vuelve a conectar Claude o ChatGPT.

¿Con «Full» el asistente puede borrar o hacer transferencias?

No. El conector no tiene herramientas de borrado ni de transferencias, y cada escritura te la pide confirmar antes.

Soy asesoría: ¿qué permisos pido a mis clientes?

Para revisar, la columna «Solo consultas». Si vais a registrar compras o asientos, la de «Asesoría». Cada empresa crea su clave en su propio Holded; mira la guía para asesorías.

¿Y CRM, Proyectos, Inventario o Equipo?

El conector no los usa: déjalos en «Ninguno».