Saltar al contenido

Resolución de problemas

El chat con IA no responde

Posibles causas:

  • Los documentos todavía están en procesamiento.
  • Tu cuenta no tiene la capacidad de chat activa o no tiene consultas IA disponibles.
  • Alcanzaste el límite de consultas IA de tu plan.
  • Tu sesión expiró y necesitas volver a autenticarte.

Qué revisar:

  1. Confirma que la licitación esté lista para retrieval y revisa el manifiesto de preparación.
  2. Revisa tu estado de cuenta en Cuenta y uso.
  3. Vuelve a cargar la página o inicia sesión nuevamente.

No encuentro una licitación por ID

Si la licitación existe en Mercado Público pero aún no aparece en LicitaIQ, la plataforma puede cargar su metadata bajo demanda. En ese caso, es esperable que tarde un momento antes de que la ficha esté disponible. Esta carga no prepara documentos y sigue dentro del catálogo gratuito.

Llegué a un límite de uso

Cuando no queda capacidad disponible:

  • Las licitaciones preparadas, búsquedas MCP o consultas IA afectadas quedan pausadas.
  • Puedes comprar una recarga del cupo agotado si tienes un plan activo.
  • Si estás en trial vencido, el catálogo y la ficha siguen disponibles; primero debes activar LicitaIQ MCP para iniciar una nueva preparación o usar capacidades premium.

El agente MCP no puede buscar documentos

Posibles causas:

  • la licitación todavía no fue activada
  • los documentos siguen en procesamiento
  • alcanzaste el límite de búsquedas documentales MCP
  • el token no tiene el scope documents:search

Qué revisar:

  1. Usa get_tender_status. Si el estado es details_not_loaded, solicita consentimiento y llama activate_tender; luego vuelve a consultar el estado que devolvió.
  2. Si el estado es files_not_started, solicita consentimiento y llama download_tender_files para iniciar la preparación explícita.
  3. Si está descargando o procesando, usa refresh_tender_preparation para actualizar el manifiesto; no inicia otro workflow.
  4. Confirma que ready_for_retrieval sea verdadero antes de buscar documentos.
  5. Confirma que tu cuenta tenga la capacidad de retrieval y búsquedas MCP disponibles, y revisa los scopes otorgados al cliente externo.

Veo errores de autenticación

Un error de autenticación suele indicar que tu token expiró, es inválido o no fue enviado correctamente. En ese caso:

  • cierra sesión y vuelve a entrar
  • repite la operación
  • si el problema persiste, valida con soporte que tu acceso esté activo

No recibo el código por correo

Si elegiste ingresar con correo electrónico y el código no llega:

  • revisa tu bandeja de entrada y la carpeta de spam o correo no deseado
  • espera unos minutos, porque algunos correos pueden demorarse
  • usa Reenviar para solicitar un nuevo código
  • usa Editar si escribiste mal tu correo electrónico
  • si el problema continúa, contacta a soporte para validar tu acceso

Los documentos no se procesan de inmediato

Esto puede ocurrir por volumen, disponibilidad de archivos o tiempos del pipeline de ingestión. Actualiza el manifiesto; si un archivo está en waiting o processing, espera antes de volver a consultar. Mientras tanto, puedes revisar la ficha general de metadata.

Un archivo falló durante la preparación

  1. Actualiza el manifiesto de preparación.
  2. Identifica el archivo con state: failed y revisa su categoría: archivo comprimido, procesamiento o indexación.
  3. Reintenta solo si aparece retryable: true, usando su file_ref desde la web, REST o MCP.
  4. Si está skipped, no es un fallo reintentable: puede corresponder a un formato no soportado o a un límite de archivos comprimidos.

El reintento no consume una preparación adicional y no reprocesa los archivos que ya están disponibles. Si el manifiesto devuelve file_not_retryable o invalid_file_reference, no repitas la acción a ciegas: vuelve a actualizarlo primero.

Mercado Público bloqueó la preparación

Mercado Público puede denegar temporalmente el acceso a archivos o exigir una verificación de bot, CAPTCHA u otro control externo. LicitaIQ muestra ese bloqueo como un fallo seguro y no descuenta una preparación que no dejó documentos utilizables.

No intentes solucionar el bloqueo con reintentos repetidos ni esperes que LicitaIQ eluda CAPTCHA. Verifica el ID y la disponibilidad del proceso en Mercado Público, conserva la hora aproximada y el ID de licitación, y contacta a soporte si el problema persiste.

Cuándo escalar el problema

Escala con soporte cuando:

  • una licitación sigue sin aparecer después de varios intentos
  • el procesamiento queda detenido por mucho tiempo o un archivo reintentable falla nuevamente
  • Mercado Público bloquea la preparación y necesitas reportar el caso
  • tu cuenta muestra un estado incompatible con tu plan activo
  • un cliente MCP autorizado recibe errores de scope o audience

Incluye el ID de la licitación, el estado agregado, el file_ref solo si aparece en el manifiesto y la hora aproximada. Puedes escribir a contacto@licitaiq.cl.