Mensajes de error y cómo resolverlos

Aquí tienes los avisos que pueden aparecer al conectar Holded o al usar el conector en Claude y ChatGPT, qué significan y qué hacer. Busca el texto del mensaje que te ha salido.

Mensajes frecuentes

«Falta este permiso: Ventas → Facturas: Leer» (o cualquier otra área)
Qué significa: La clave no tiene permiso para leer esa parte de Holded.
Qué hacer: En Holded edita la clave (Configuración → Desarrolladores → Credenciales), pon esa área en «Full» (o «Leer») y guarda. No hace falta crear otra clave ni volver a conectar. Recuerda que «Escribir» no incluye «Leer». Más detalles en la guía de permisos.
«Al token de Holded le falta este permiso: Cuenta → Información de la cuenta: Leer»
Qué significa: Sin este permiso no podemos saber a qué empresa pertenece la clave, así que no podemos conectarla sin riesgo de confundir empresas.
Qué hacer: Edita la clave en Holded, pon «Cuenta» (o «Información de la cuenta») en «Leer», guarda y vuelve a pegarla.
En Holded, «Desarrolladores» solo muestra «Webhooks» y no hay «Credenciales»
Qué significa: Suele pasar en empresas gestionadas por una asesoría que no tienen licencia propia de Holded, o con un usuario sin permiso de desarrollador.
Qué hacer: Comprueba que entras con el propietario o un administrador de la empresa. Si la empresa no tiene licencia propia, no se puede crear la clave y no se puede conectar. Si llegaste desde «Conectar otra empresa», usa «Volver a la autorización» para seguir con tus otras empresas. Más en la guía para asesorías.
«Esta clave es del formato antiguo de Holded» / «clave antigua»
Qué significa: La clave es de las antiguas (32 letras y números, sin pat_). El conector solo funciona con las claves nuevas.
Qué hacer: Crea una clave nueva en Holded → Configuración → Desarrolladores → Credenciales (no en «Api Keys v1») y conéctala. Paso a paso en la guía de la clave.
«La API key no está completa» o «no tiene el formato de Holded»
Qué significa: Se ha pegado solo una parte de la clave, normalmente copiada de la lista de Holded.
Qué hacer: Holded enseña la clave completa solo al crearla. Si no la copiaste entonces, crea otra y pulsa el botón de copiar en esa misma ventana.
«Esta clave es de [empresa], que ya está conectada»
Qué significa: Querías añadir otra empresa, pero la clave es de una empresa que ya tienes (muy habitual: pegar la clave de la asesoría en vez de la del cliente).
Qué hacer: Necesitas la clave creada dentro del Holded de la otra empresa. Mira cómo pedírsela al cliente en la guía para asesorías.
«Esta clave es de otra empresa. Para no mezclar datos, añádela como empresa nueva»
Qué significa: Has intentado guardar la clave de una empresa encima de otra distinta. Lo bloqueamos para que una empresa nunca muestre los datos de otra.
Qué hacer: Añádela como empresa nueva: en el panel, «Empresas → Añadir empresa»; en Claude o ChatGPT, «Conectar otra empresa» en la pantalla de autorizar.
Al añadir otra conexión en Claude o ChatGPT no me pide la clave
Qué significa: Ya tienes sesión abierta en isaak.pro con una empresa conectada, así que la pantalla va directa a «Autorizar» esa empresa.
Qué hacer: En la pantalla de autorizar pulsa «Conectar otra empresa (pegar su clave)». Si ya tenías ese asistente autorizado, verás un aviso arriba con ese botón. Ponerle otro nombre al conector no cambia de empresa.
«No encuentro la empresa … entre las de esta conexión»
Qué significa: Has pedido una empresa que esta autorización no incluye: no está conectada o autorizaste «solo esta empresa».
Qué hacer: Pregunta al asistente «¿con qué empresas puedes trabajar?». Si falta, conéctala y vuelve a autorizar con «todas mis empresas».
«… coincide con varias empresas»
Qué significa: El nombre que has dado encaja con más de una de tus empresas.
Qué hacer: Indica el CIF o el nombre completo de la empresa.
«Tu usuario solo tiene permiso de lectura en …»
Qué significa: En esa empresa tienes acceso de solo lectura: puedes consultar, pero no crear ni modificar.
Qué hacer: Pide a un administrador de la empresa que te dé acceso completo en Panel → Usuarios.
«La empresa … no está disponible ahora mismo»
Qué significa: Su conexión con Holded se ha desconectado o ya no tienes acceso a ella.
Qué hacer: Revísala en Panel → Conexiones y, si hace falta, vuelve a conectar su clave.
«La clave guardada no se puede leer»
Qué significa: La conexión existe, pero la clave guardada ya no sirve (por ejemplo, tras un cambio de seguridad).
Qué hacer: Desconecta esa conexión en Panel → Conexiones y vuelve a conectar con la clave de Holded.
«Esta empresa ha agotado el cupo mensual de la API de Holded»
Qué significa: Holded limita las llamadas a la API por empresa y mes. Se ha llegado al límite.
Qué hacer: Holded lo renueva al empezar el mes. Si das permiso «Desarrolladores → Uso: Leer», el asistente te avisará antes de llegar al límite.
«Holded está limitando las peticiones de esta empresa»
Qué significa: Se han hecho muchas consultas seguidas.
Qué hacer: Espera unos segundos y vuelve a intentarlo.
El asistente me enseña otra empresa
Qué significa: Has entrado en isaak.pro con otra cuenta, o la autorización es de otra empresa.
Qué hacer: En la pantalla de autorizar comprueba el nombre y el CIF. Si no es tu cuenta, usa «Entrar con otra cuenta». Revisa también Panel → Conexiones.

Aquí tienes los avisos que pueden aparecer al conectar Holded o al usar el conector en Claude y ChatGPT, qué significan y qué hacer. Busca el texto del mensaje que te ha salido.

Mensajes frecuentes

«Falta este permiso: Ventas → Facturas: Leer» (o cualquier otra área)
Qué significa: La clave no tiene permiso para leer esa parte de Holded.
Qué hacer: En Holded edita la clave (Configuración → Desarrolladores → Credenciales), pon esa área en «Full» (o «Leer») y guarda. No hace falta crear otra clave ni volver a conectar. Recuerda que «Escribir» no incluye «Leer». Más detalles en la guía de permisos.
«Al token de Holded le falta este permiso: Cuenta → Información de la cuenta: Leer»
Qué significa: Sin este permiso no podemos saber a qué empresa pertenece la clave, así que no podemos conectarla sin riesgo de confundir empresas.
Qué hacer: Edita la clave en Holded, pon «Cuenta» (o «Información de la cuenta») en «Leer», guarda y vuelve a pegarla.
En Holded, «Desarrolladores» solo muestra «Webhooks» y no hay «Credenciales»
Qué significa: Suele pasar en empresas gestionadas por una asesoría que no tienen licencia propia de Holded, o con un usuario sin permiso de desarrollador.
Qué hacer: Comprueba que entras con el propietario o un administrador de la empresa. Si la empresa no tiene licencia propia, no se puede crear la clave y no se puede conectar. Si llegaste desde «Conectar otra empresa», usa «Volver a la autorización» para seguir con tus otras empresas. Más en la guía para asesorías.
«Esta clave es del formato antiguo de Holded» / «clave antigua»
Qué significa: La clave es de las antiguas (32 letras y números, sin pat_). El conector solo funciona con las claves nuevas.
Qué hacer: Crea una clave nueva en Holded → Configuración → Desarrolladores → Credenciales (no en «Api Keys v1») y conéctala. Paso a paso en la guía de la clave.
«La API key no está completa» o «no tiene el formato de Holded»
Qué significa: Se ha pegado solo una parte de la clave, normalmente copiada de la lista de Holded.
Qué hacer: Holded enseña la clave completa solo al crearla. Si no la copiaste entonces, crea otra y pulsa el botón de copiar en esa misma ventana.
«Esta clave es de [empresa], que ya está conectada»
Qué significa: Querías añadir otra empresa, pero la clave es de una empresa que ya tienes (muy habitual: pegar la clave de la asesoría en vez de la del cliente).
Qué hacer: Necesitas la clave creada dentro del Holded de la otra empresa. Mira cómo pedírsela al cliente en la guía para asesorías.
«Esta clave es de otra empresa. Para no mezclar datos, añádela como empresa nueva»
Qué significa: Has intentado guardar la clave de una empresa encima de otra distinta. Lo bloqueamos para que una empresa nunca muestre los datos de otra.
Qué hacer: Añádela como empresa nueva: en el panel, «Empresas → Añadir empresa»; en Claude o ChatGPT, «Conectar otra empresa» en la pantalla de autorizar.
Al añadir otra conexión en Claude o ChatGPT no me pide la clave
Qué significa: Ya tienes sesión abierta en isaak.pro con una empresa conectada, así que la pantalla va directa a «Autorizar» esa empresa.
Qué hacer: En la pantalla de autorizar pulsa «Conectar otra empresa (pegar su clave)». Si ya tenías ese asistente autorizado, verás un aviso arriba con ese botón. Ponerle otro nombre al conector no cambia de empresa.
«No encuentro la empresa … entre las de esta conexión»
Qué significa: Has pedido una empresa que esta autorización no incluye: no está conectada o autorizaste «solo esta empresa».
Qué hacer: Pregunta al asistente «¿con qué empresas puedes trabajar?». Si falta, conéctala y vuelve a autorizar con «todas mis empresas».
«… coincide con varias empresas»
Qué significa: El nombre que has dado encaja con más de una de tus empresas.
Qué hacer: Indica el CIF o el nombre completo de la empresa.
«Tu usuario solo tiene permiso de lectura en …»
Qué significa: En esa empresa tienes acceso de solo lectura: puedes consultar, pero no crear ni modificar.
Qué hacer: Pide a un administrador de la empresa que te dé acceso completo en Panel → Usuarios.
«La empresa … no está disponible ahora mismo»
Qué significa: Su conexión con Holded se ha desconectado o ya no tienes acceso a ella.
Qué hacer: Revísala en Panel → Conexiones y, si hace falta, vuelve a conectar su clave.
«La clave guardada no se puede leer»
Qué significa: La conexión existe, pero la clave guardada ya no sirve (por ejemplo, tras un cambio de seguridad).
Qué hacer: Desconecta esa conexión en Panel → Conexiones y vuelve a conectar con la clave de Holded.
«Esta empresa ha agotado el cupo mensual de la API de Holded»
Qué significa: Holded limita las llamadas a la API por empresa y mes. Se ha llegado al límite.
Qué hacer: Holded lo renueva al empezar el mes. Si das permiso «Desarrolladores → Uso: Leer», el asistente te avisará antes de llegar al límite.
«Holded está limitando las peticiones de esta empresa»
Qué significa: Se han hecho muchas consultas seguidas.
Qué hacer: Espera unos segundos y vuelve a intentarlo.
El asistente me enseña otra empresa
Qué significa: Has entrado en isaak.pro con otra cuenta, o la autorización es de otra empresa.
Qué hacer: En la pantalla de autorizar comprueba el nombre y el CIF. Si no es tu cuenta, usa «Entrar con otra cuenta». Revisa también Panel → Conexiones.