# Context pack: Solución de problemas Source: https://nordvec.com/es/docs/guides/troubleshooting Pack: https://nordvec.com/es/docs/packs/troubleshooting This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [Errores y límites de frecuencia](https://nordvec.com/es/docs/guides/errors-and-rate-limits) (builds on) 2. [Solución de problemas](https://nordvec.com/es/docs/guides/troubleshooting) (this guide) 3. [Vuelve a conectar un conector](https://nordvec.com/es/docs/guides/troubleshooting/reconnect-integration) (linked from this guide) 4. [Concede los permisos que faltan](https://nordvec.com/es/docs/guides/troubleshooting/insufficient-scopes) (linked from this guide) 5. [Límite de documentos alcanzado](https://nordvec.com/es/docs/guides/troubleshooting/document-limit) (linked from this guide) 6. [Límite diario de procesamiento alcanzado](https://nordvec.com/es/docs/guides/troubleshooting/daily-processing-limit) (linked from this guide) --- # Errores y límites de frecuencia Source: https://nordvec.com/es/docs/guides/errors-and-rate-limits El sobre de error único que devuelve cada solicitud fallida, los encabezados de límite de frecuencia y cómo reintentar una escritura de forma segura. Cada endpoint falla de la misma manera, por lo que un cliente maneja errores, límites de tasa y reintentos una vez y reutiliza ese código en todas partes, incluso sobre [MCP](/docs/guides/mcp). ## El sobre de error [#el-sobre-de-error] Toda respuesta que no sea 2xx es un objeto JSON: ```json { "defined": false, "code": "TOO_MANY_REQUESTS", "message": "Too many requests", "data": { "reason": "rate_limit.exceeded", "retryAfterMs": 12000 } } ``` * `code` es el error a nivel HTTP, por ejemplo `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `BAD_REQUEST` o `TOO_MANY_REQUESTS`. * `data.reason`, cuando está presente, es una razón más precisa legible por máquina, como `auth.key_not_found` o `rate_limit.exceeded`. Haz branching sobre ella en lugar de sobre `message`, que es para personas y puede cambiar. * `defined` es `true` cuando la operación lista ese error en la [referencia de la API](/docs/api), y `false` para errores que cualquier solicitud puede encontrar (autenticación, límites de tasa, una ruta desconocida). * Un fallo de validación responde `BAD_REQUEST` con los problemas en `data.formErrors` y `data.fieldErrors`. Toda respuesta también lleva un `X-Request-ID`. Cítalo cuando contactes con soporte, y podremos encontrar esa solicitud exacta. ## Estados comunes [#estados-comunes] | Estado | Código | Qué hacer | | ------ | ----------------------- | ----------------------------------------------------------------------------------- | | `400` | `BAD_REQUEST` | Corrige la solicitud; `data.fieldErrors` nombra los campos | | `401` | `UNAUTHORIZED` | Envía una clave o sesión válida | | `403` | `FORBIDDEN` | La clave carece del ámbito o el rol que necesita la operación | | `404` | `NOT_FOUND` | El recurso no existe, o no tienes permiso para verlo | | `409` | `CONFLICT` | Una escritura duplicada aún está en curso; reintenta en breve | | `413` | `PAYLOAD_TOO_LARGE` | El cuerpo de la solicitud supera 1 MB; divide un envío masivo en lotes más pequeños | | `422` | `UNPROCESSABLE_CONTENT` | La solicitud está bien formada pero no se puede aplicar | | `429` | `TOO_MANY_REQUESTS` | Espera `Retry-After`, luego reintenta | ## Límites de tasa [#límites-de-tasa] Cada respuesta indica el límite contra el que se contó, en dos formas: * los encabezados `X-RateLimit-*`; * los campos estructurados IETF `RateLimit` (estado en vivo: `r` son las solicitudes restantes, `t` los segundos hasta que se reinicie la ventana) y `RateLimit-Policy` (la cuota: `q` es el límite, `w` la ventana en segundos). Un `429` también lleva `Retry-After` en segundos y `data.retryAfterMs`. Espera al menos ese tiempo antes de la siguiente solicitud; reintentar antes se cuenta y se rechaza de nuevo. ## Reintentos de escrituras de forma segura [#reintentos-de-escrituras-de-forma-segura] Una operación de escritura que lista un encabezado `Idempotency-Key` en la [referencia de la API](/docs/api) se puede reintentar sin realizar el trabajo dos veces. Envía una clave por cada escritura lógica y repite la misma clave en cada reintento: * la misma clave con el mismo cuerpo en un plazo de 24 horas reproduce la respuesta almacenada; * la misma clave con un cuerpo diferente se rechaza con `422`; * un duplicado que llega mientras la primera aún se está ejecutando recibe `409`. Una operación sin el encabezado no es idempotente, así que reinténtala solo cuando sepas que el primer intento no se completó. --- # Solución de problemas Source: https://nordvec.com/es/docs/guides/troubleshooting Soluciones para los errores de sincronización y los límites del plan con los que te puedes encontrar, cada una empezando por el mensaje que ves. Cada página comienza con el mensaje que te muestra Nordvec, explica por qué aparece y te guía paso a paso para solucionarlo. Si buscas errores que devuelve una solicitud a la API, consulta [Errores y límites de frecuencia](/docs/guides/errors-and-rate-limits). - [Vuelve a conectar un conector](https://nordvec.com/es/docs/guides/troubleshooting/reconnect-integration): Soluciona los errores de sincronización "la autenticación ha caducado" y "el acceso ha sido revocado" volviendo a conectar el conector afectado. - [Concede los permisos que faltan](https://nordvec.com/es/docs/guides/troubleshooting/insufficient-scopes): Soluciona los errores de sincronización por "permisos requeridos que faltan" volviendo a conectar el conector y aprobando todos los permisos solicitados. - [Límite de documentos alcanzado](https://nordvec.com/es/docs/guides/troubleshooting/document-limit): Qué ocurre cuando el límite de documentos de tu plan pausa la sincronización, y cómo liberar espacio o actualizar para reanudarla. - [Límite diario de procesamiento alcanzado](https://nordvec.com/es/docs/guides/troubleshooting/daily-processing-limit): Qué ocurre cuando el límite diario de procesamiento de tu espacio de trabajo pausa la sincronización y cuándo se reanuda. --- # Vuelve a conectar un conector Source: https://nordvec.com/es/docs/guides/troubleshooting/reconnect-integration Soluciona los errores de sincronización "la autenticación ha caducado" y "el acceso ha sido revocado" volviendo a conectar el conector afectado. Cuando una sincronización informa de **"Tu autenticación ha caducado"** o **"Se ha revocado tu acceso"**, Nordvec ya no puede actuar en tu nombre en el proveedor. Es necesario renovar la conexión; reintentar la sincronización sin volver a conectar no servirá de nada. ## Por qué ocurre esto [#por-qué-ocurre-esto] * El proveedor ha caducado la credencial de larga duración que Nordvec tiene. Algunos proveedores lo hacen en un plazo fijo, otros tras un periodo de inactividad. * Has cambiado tu contraseña en el proveedor, lo que suele revocar el acceso a todas las aplicaciones conectadas. * Tú (o un administrador del espacio de trabajo) has revocado el acceso de Nordvec desde la configuración de aplicaciones conectadas o de seguridad del proveedor. * El proveedor ha actualizado su política de seguridad (por ejemplo, tras detectar actividad sospechosa en tu cuenta) e invalidado los permisos existentes. ## Cómo solucionarlo [#cómo-solucionarlo] 1. Abre **Connectors** en Nordvec. 2. Busca el conector afectado. Muestra el estado de error de la última sincronización y un botón **Reconectar** en su tarjeta. 3. Selecciona **Reconectar** e inicia sesión en el proveedor con la **misma cuenta** que conectaste originalmente. Aprueba todos los permisos que indique el proveedor; rechazar alguno provocará un [error de permisos faltantes](/docs/guides/troubleshooting/insufficient-scopes) en su lugar. Reconectar también está disponible desde los detalles del conector en cualquier momento, no solo tras un error. Reconectar mantiene todo lo ya sincronizado. No uses **Desconectar** para solucionar un inicio de sesión caducado: desconectar elimina de forma permanente todos los documentos que el conector sincronizó. Si inicias sesión con una cuenta diferente a la que configuraste originalmente para el conector, Nordvec rechazará la reconexión y no realizará ningún cambio. Para cambiar de cuenta, desconecta el conector y conecta la otra cuenta en su lugar. ### Conectores que no se pueden reconectar directamente [#conectores-que-no-se-pueden-reconectar-directamente] Guru, Notion, Zendesk, Freshdesk, Trello y e-conomic no ofrecen la opción **Reconectar**, ya que Nordvec no puede confirmar que un nuevo inicio de sesión pertenezca a la misma cuenta. Para estos, desconecta el conector y vuélvelo a conectar. Desconectar elimina los documentos que sincronizó, y la siguiente sincronización los importará de nuevo desde cero. ## Qué ocurre tras reconectar [#qué-ocurre-tras-reconectar] El nuevo inicio de sesión reemplaza al anterior y se borra el error. Se inicia una sincronización de inmediato, y los documentos que fallaron mientras la conexión estaba inactiva se reintentan; los elementos listados bajo **"Elementos que no se pudieron importar"** desaparecen a medida que se importan correctamente. Los conectores están conectados por usuario: reconectar renueva *tu* conexión y no afecta a la de los demás. Solo la persona que conectó un conector puede reconectarlo, y esto incluye a los administradores del espacio de trabajo: un administrador no puede reconectar el conector de un compañero. --- # Concede los permisos que faltan Source: https://nordvec.com/es/docs/guides/troubleshooting/insufficient-scopes Soluciona los errores de sincronización por "permisos requeridos que faltan" volviendo a conectar el conector y aprobando todos los permisos solicitados. Cuando una sincronización informa de **"Faltan permisos necesarios en tu cuenta"**, la conexión con el proveedor funciona, pero se le han concedido menos permisos (ámbitos OAuth) de los que el conector necesita para leer tu contenido. Esto es una propiedad del propio permiso concedido, por lo que la única solución es volver a realizar la conexión con el conjunto completo de permisos. ## Por qué ocurre esto [#por-qué-ocurre-esto] * Se rechazó un permiso durante el flujo de conexión original. Algunos proveedores permiten desmarcar permisos individuales en la pantalla de consentimiento. * El conector ha adquirido una nueva capacidad que requiere un permiso adicional, y tu concesión anterior es anterior a este cambio. * Un administrador del espacio de trabajo ha restringido qué permisos pueden tener las aplicaciones de terceros, o el proveedor requiere aprobación del administrador para algunos de ellos. ## Cómo solucionarlo [#cómo-solucionarlo] 1. Abre **Connectors** en Nordvec. 2. Busca el conector afectado y elige **Reconectar** en su tarjeta. 3. Inicia sesión con la misma cuenta que conectaste originalmente y, en la pantalla de consentimiento del proveedor, aprueba **todos** los permisos solicitados. Cada uno corresponde a una necesidad concreta, normalmente la lectura de los documentos, archivos o mensajes que sincroniza el conector; no hay extras opcionales en la lista. Al reconectar, se conservan los documentos ya sincronizados. Guru, Notion, Zendesk, Freshdesk, Trello y e-conomic no se pueden reconectar en el mismo lugar; para estos, desconecta y vuelve a conectar, lo que eliminará los documentos sincronizados e los importará de nuevo desde el principio. Si la pantalla de consentimiento indica que un administrador debe aprobar la aplicación, reenvía la solicitud a tu administrador del espacio de trabajo. Los proveedores con flujos de consentimiento de administrador (por ejemplo, organizaciones de Google Workspace y Microsoft 365, o espacios de trabajo de Slack con aprobación de aplicaciones) bloquean la concesión hasta que un administrador la apruebe, y reconectar antes de esa aprobación producirá el mismo error. ## Qué ocurre después de reconectar [#qué-ocurre-después-de-reconectar] La nueva concesión reemplaza a la anterior, se borra el error y comienza una sincronización de inmediato. Los elementos que antes fallaban por errores de permisos se reintentan. --- # Límite de documentos alcanzado Source: https://nordvec.com/es/docs/guides/troubleshooting/document-limit Qué ocurre cuando el límite de documentos de tu plan pausa la sincronización, y cómo liberar espacio o actualizar para reanudarla. Cuando una sincronización informa de **"Has alcanzado el límite de documentos de tu plan"**, la conexión está sana y no ha fallado nada en el proveedor. Simplemente, tu corpus ha llegado al número máximo de documentos que permite tu plan, por lo que la importación se pausó en lugar de descartar contenido en silencio. ## Qué cubre el límite [#qué-cubre-el-límite] El límite cuenta los documentos almacenados en tu corpus de todas las fuentes: sincronizaciones de conectores, subidas y documentos enviados a través de la API. Existe para mantener predecibles los costes de indexación y búsqueda; es una asignación por espacio de trabajo, no por conector. ## Cómo reanudar la sincronización [#cómo-reanudar-la-sincronización] Haz una de las siguientes acciones: * **Libera espacio.** Elimina documentos que ya no necesites o desconecta una fuente cuyo contenido no quieras indexar. Al eliminar un documento, se retira del índice de inmediato. * **Mejora tu plan o añade asientos.** La asignación se establece por asiento, y los planes superiores permiten más documentos por asiento. No es necesario reiniciar manualmente después: la siguiente sincronización programada detecta la capacidad liberada y reanuda desde donde se detuvo. También puedes activar una sincronización manualmente desde la tarjeta del conector una vez que haya espacio disponible. ## Qué ocurre con los documentos que no cupieron [#qué-ocurre-con-los-documentos-que-no-cupieron] Nada se pierde en la fuente; el proveedor sigue siendo el sistema de registro. Los documentos que no se pudieron importar se recogen en la siguiente sincronización exitosa una vez que haya capacidad disponible. --- # Límite diario de procesamiento alcanzado Source: https://nordvec.com/es/docs/guides/troubleshooting/daily-processing-limit Qué ocurre cuando el límite diario de procesamiento de tu espacio de trabajo pausa la sincronización y cuándo se reanuda. Cuando una sincronización informa de **"Tu espacio de trabajo ha alcanzado el límite de procesamiento de hoy"**, la conexión está sana y no ha fallado nada en el proveedor. Tu espacio de trabajo ha procesado tanto contenido nuevo en un día como permite su límite, por lo que la importación se pausó en lugar de seguir rechazando elementos uno a uno. ## Qué cubre el límite [#qué-cubre-el-límite] El límite cuenta el contenido procesado para indexación en todas las fuentes (sincronizaciones de conectores, subidas, documentos enviados a través de la API) en un día natural, medido en UTC. Existe para evitar que la primera sincronización de una fuente grande se ejecute sin límites en un solo día; el contenido sin cambios nunca vuelve a contar, por lo que, tras la importación inicial, un espacio de trabajo rara vez se acerca a él. El límite es una asignación por espacio de trabajo que escala con el número de plazas, y cada miembro puede usar una parte de él al día, por lo que la importación grande de una persona no puede agotar toda la asignación del espacio de trabajo. ## Cómo se reanuda la sincronización [#cómo-se-reanuda-la-sincronización] No hay que hacer nada. El conector está programado para ejecutarse de nuevo después de la medianoche UTC, cuando se reinicia la asignación diaria, y continúa desde donde se detuvo. El mensaje de estado se borra en esa ejecución. También puedes activar una sincronización manualmente desde la tarjeta del conector; retomará el proceso donde lo dejó la anterior una vez que la asignación esté disponible. ## Qué ocurre con el contenido que no se procesó [#qué-ocurre-con-el-contenido-que-no-se-procesó] No se pierde nada en la fuente; el proveedor sigue siendo el sistema de registro. Los elementos que no se pudieron procesar hoy serán recogidos por la siguiente ejecución.